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AMIGA HAS MULTI-TASKING, 
DISCOVERY SOFTWARE USES IT! 

FROM NOW ON YOU CAN PRINT OR SAVE 
ANY SCREEN, FROM ANY PROGRAM, ANY TIME! 



GlLABBiT takes WYSIWYG* to the limit. 
With GRABBiT you capture exactly wliat you 
see on your screen in an instant, regardless 
of what other programs you're running. 
GRABBiT works with all AMIGA video 
modes, including "Iloid-and-Motlify'Mt 
even lets you capture images from animated 
programs, like the bouncing ball in Boing! 
What's more, GRj\liI!iT runs completely in 
the background - transparent to your other 
softwzre. GRABBIT is always ready for you 
to use, even while you're in the middle of 
another program. As if that's not enough, 
GRABBiT requires only about lOK of your 
precious RAM to operate, asid it supports 
dozens of printers. It's not a game, its not a 
toy. GRABBiT is truly a productivity power 
tool for your AMIGA! 

We believe powerful software should t>e 
easy to use. GRyVBBiT is one of the EASIEST 
programs you'll ever usel Every GRABBiT 
operation is triggered by one ot the 
"HotKeys", a set of easy- to- remember key 
sequences that only take minutes to learn. 
Each HotKey is generated simply by holding 
down the "Control" and "Alt" keys and 
pressing one of the designated letter keys. 
What could be easier? 



You won't grow old waiting lor GHAUUif 
to finish printing, either. When we say mnlti' 
tasking, we mean it. GR.'VBBiT has a uniciue 
TPM (Task Priority Monitor) module 
which makes sure your other software can 
still run even while GRABBiT is printing. The 
TPM module constantly tracks GRAHIHT's 
printing priority, nraking sure it is neither loo 
high nor too low. hiil always just right! 
GILABBIT adds a new dimension to the 
A.\nG.'\'s multi-tasking capability, 

GRABBiT supports dozens of differen! 
printers because it uses the standard Amiga 
device drivers. Any printer you can choose 
in "Preferences" is automatically supported 
by GRABBiT. You'll get the most from color 
printers too, because GRABBiT supports full- 
color printing. In fact, we have seen amazing 
color printouts prixiuced by GRABBiT on the 
Oki-Mate 20, a color printer costing less than 
$200.00. 

Of course. GRABBiT's abilities are not 
limited merely to printing; CIWBBiT is 
equally adept at saving screen images to 
disk -ves, even HAM screens,' AU GRABBiT 



disk hies are saved in the popular IFF 
format, the emerging graphics standard tor 
AMIGA. You can capture any screen to disk 
(or slide-show presentations or later 
enhancement with any popular AMIGA 
graphics editor like AEGIS Images or Deluxe 
Paint. We even include a specially modified 
PD utility called "SEE", which allows you to 
view IFF image files quickly and easily. 
GRABBiT's disk operations are lightning fast 
because GRABBiT is written in a hybrid of 
highly optimized C and 68000 Assembler. 

Once you sliirl using GRABBIT you'll 
want it on every disk. You can easily install 
GRABBiT in your system 5turtu])-sei]uence, 50 
it will always be there when you need it. 
With all its features this would be a great 
package at any price. But we think you'll 
agree with us that GRABBiT's most 
outstanding feature is VALUE! You get all 
the power of this sizzling new software for 
an unbelievably low 
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The Editor 
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From the Editor: 

by Don Hicks 



Of Comdex and Layoffs 

We have a saying in New England, originally quoted from f^/lark 
Twain, '"if you don't like the weather, just wait five minutes." 
With very little effort, this can be applied to the micro 
computer market. 

Comdex 

At the end of April, we were excited by the prospects and 
great software we saw at Comdex in Atlanta. Commodore's 
large booth was a mecca to software developers. There was 
easily more going on per square foot in that booth then in any 
other section of Comdex. Commodore had Amiga stations 
strategically scattered through the booth and each was 
manned by smiling software developers ( each showing their 
products at Comdex without paying the high prices for floor 
space). 

The effect worked! Press and dealers were swarming through 
the booth, visiting the different stations and getting a first 
look at some of the power software on the way. 

The Amiga's graphics, sound, and depth were demonstrated 
and extended by dozens of new programs and peripherals. 
The effect was euphoric. We came away from Comdex 
pleased and excited with the way the Amiga was attacking 
and attracting the market. 

Our course was set. We had wanted this issue to be a 
"Comdex" issue and our best expectations had been realized. 
We hurried back to our desks and began sorting through the 
pounds of material we had collected. 

Oh Well, 

A few weeks later, as we were chasing authors for their 
promised columns, the news reached us of the layoffs at 
Commodore. (Naturally the authors wanted to pull their 
stories for rewrite.) There were no fancy press releases, just 
the murmur of rumors moving through the networks. The cuts 
had come swiftly to all departments, "no one area was cut 
over another", one executive said. Another Commmodore 
representative staled that the essintial areas were left intact 
and that only a few management and artists were released. 

The effective line from most lop officials was that the cuts 
were made across the board for cost effectiveness. 

This placed a rather large gloom on our Comdex stories. 
Commodore may have dropped a few people, but why did they 
always seem to be the people we knew and with which we 
talked? 

When I asked one Commodore offical about the layoffs, he 
replied, "What is the concern about a corporation's internal 
structure. When I buy a Volvo, I don't worry about who is the 
president." 



I countered by asking the official when was the last time he 
picked up a magazine devoted to the Volvo. 

Bad News? 

Although we have lost a good many friends and great people 
from Commodore's ranks, we believe that this was good news 
overall. If Commodore's claim that they will continue to handle 
development and support of the Amiga with the remaining 
staff is true, then they have done what they had to do to get 
profits up white sales remain high. (See the Amigo's column, 
"Roomers", for an alternative posiSiorii on the development 
viewpoint.) 

Commodore's sales have been up, especially after the spring 
promotion. Yet, with their pas! reported losses. Commodore 
is under pressure to cu! costs. Personnel is always the 
largest and easily cut portion of the budget. To be fair, 
Commodore had already closed some manufacturing 
sections. 

The good news, Commodore made this decision. It was not a 
directive from their bankers. It was a difficult and unpolpular 
decision and Commodore made it when they could have 
continued in the appearance of increased sales. That takes 
courage. 

Apple Computer made the same decision last year. Oh they 
were not under the same cash crunch as Commodore, but 
they were under pressure to place their operations in line. 
They shut down plants, discontinued the Lisa Computer, and 
released or shuffled personnel. They received flack from 
almost all sections of the media and suffered the bad press of 
suing their resigning founder, Mr. Jobs. 

What was the result of all these difficult decisions? Apple 
reported one of their best quarters ever. They became the 
darlings of the media and the Macintosh ( you remember that 
computer that did not have enough software last year) has 
been termed by quotes in Infoworld as the second business 
computer format. Not Bad. 

The Future 

Commodore has taken the steps to secure their position 
financially. The Amiga has certainly taken a lead technically. 
And, through Comdex, software and hardware developers 
have taken the Amiga to the market. The future rests in how 
well each has done its job. 



What do I believe? I just bought another Amiga, 




Don Hicks 
Managing Editor 
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New Amiga Products From 
The Developers of Amiga G 



Amiga C CompUer—Sl 49.95 

Ever\ tiling yoii need to de\'elop pro- 
gnuns on tlie Aniig-a, including a full 
set of libraiies, he-ader files, an oiijea 
mtxlule dis;tssembler, and sample C 
programs. 

Unicalc — $79.95 A complete spread 
sheet package for Amiga, vs'itli die pow^er- 
fijl features made [XDpukir by programs 
such as VisiQilc, Su[:)erQilc, imd Ij;)tus 
1-2-3- UniGilc pro\ides miuiy display 
options jind generates printed re}X)rts 
iji a \ariet\' of fonnats and print image 
files. SupjxirLs 8192 row's of 256 columns, 
and includes complete on-line help. 

Lattice MacLibraryr— $100 00 
Tlie Lattice MacLibran' Ls a collection of 
more than sL\t)- C fbnctioas enabling ytxi 
to rapidly con\'en your Macintosh pro- 
grams to run on tlie Amiga, tliis dlow'S 
you to quickly and efficiently take 
adv'antage of tlie powerftil capal:>ilities 
of tlie Amiga 

lattice Make Utility— $125 00 
Automiited prtxluct generation utilit\' 
for Amigi, similar to UNIX Make, LMK 
rebuilds complex programs with a single 
command. Specif\' tlie relatioasliips of 
tlie pieces, iind automatiailly rebuild 
your system the same u'a>' even' lime. 



<^ 



Lattice 



Text Utilities— $75.00 Eiglit soft- 
wMV t(X)ls for managing text files. GREP 
searches for specificxl cliiu-acter su'ings; 
D/ffcomp;ires files; £X77d4<:T creates a 
list of files to be extracted from tlie cur- 
rent directory; BUIII) cre:ites nev\' files 
from a batch'lLst; WCdLspla\'S a characier 
count iuid a checksum of a specified file; 
£D Ls a line editor v.'liich utilizes output 
from otlier Text Utilities; SPIAT is a 
search and replace function; andfn£S 
lists, copies, erases or removes files or 
entire direcion- structures. 

lattice Screen Editor (LSE)— 

$100.00 I-ast, flexilile luid easy to leani 
editor designed six-cificxilK' for prognun- 
mers. LSE's multi-window em'iroiiment 
provides tlie editcjr functioas such as 
block moves, pattern searciies, and "cut 
and paste! Plus programmer feaaires 
such as lui error u'acking mcxle and tliree 
iis.sembly liuiguage input modes. 



OTHER AMIGA PRODUCTS 
AVAILABLE FROM LAITICE: 

Panel: Screen La>'Out Utiliti^ — $195-00 

Cross Compiler: 

MS-DOS to Amiga C— $250.00 

dBCm: 

library' of data base fianctions — $150.00 

Cross Reference Generator— $4500 

Witli Lattice produas you get Lattice Ser- 
lice including telephone support, notice 
of new pnxlucts :uid enhancements, and 
a nione\'-back guarantee. Corporate 
licease ^eements available. 



Phone (312) 858-7950 TOOi 910-291-2190 

INTERNATIONAL SMJ-S OFFICES. 

Benelux: De Vcxaght. Phone t32)-2-720-91-28. England: Roundhill. Phone (0672) 54675 

Japan: Lifeboat Inc. Phone (03) 293-471 1 France: SFL. Phone (1 ) 46-66-11-55 



Amazing Computing™ © Page 



Amazing Mail: 



Dear Sirs: 

You people can be best represented by a very mean candy 
store owner. Already, there are many Amiga owners out 
there. And many have heard by word of mouth, (as I did,) 
about your magazine. But its out of our reach! We know of 
the magazine, but can't reach into the glass case, and the 
store owner (you I) wont sell them to us! 

What do I mean by this? I recently spoke with the secretary 
to Mrs. Jan Wood, the magazine buyer to B. Dalton 
Bookstores and B. Dalton Software, Etc. Apparently you 
only have the capacity to sell your magazine to dealers, (and 
selected ones at that!) and not through mass distribution. 
O.K. I can understand that. After all, not every magazine 
gets an outside company to bankroll their first three issues. 
BUT we slill can't find your magazine! 

(Please note that by now we does not include myself - I've 
been lucky enough to subscribe!) Let's face it - for your 
sake and ours - there's got to be some other major retailer 
through which we can find your magazine. By now, you have 
most certainly noticed the enclosed photocopy. It's an 
article that appeared about a locally based national retailer. 
I'm sure you've heard of "em. It's B. Dalton. Only it's not the 
bookstore we're talking about. It's their sister company, fi, 
Dalton Software. Etc. 

PLEASE! PLEASE! PLEASE! I'm sick and tired of borrowed 
out my issues of A.C.I PLEASE iet Software, Etc. be an 
exception. PLEASE let them buy your magazine directly! 
My issues are wearing out! You've gotta let these other 
people find your magazine somewhere else! 

Thank you, 
Mr.LeifO.Pihl 
Minneapolis, MN 

p.s. Please excuse any spelling as I have neither a spelling 
checker program nor a printer cable. 

Dear Mr. Pihl, 

Your letter was received wHh great interest by the staff at 

AC. We are very aware of the Amiga users who have either 

never heard of us or have never seen a copy of Amazing 

Computing. Perhaps, the best way to answer your letter 

would be to give you a short history of our magazine and 

company. 

PIM Publications Inc. was created from a dream my wife and 
I had ten years ago, when we were first married. The initals 
stand for Poetry in fvJotion. We liked the name for a 
publishing company, but at the time, we had nothing to 
publish. 

After years of working with tasks, people, computers, and 
writing, we found the Amiga. The Amiga was exactly what we 
wanted. Or rather, the Amiga with Genlock would do what 
we were currently working toward at a much reduced cost. 



We, like many, hurried to buy a developer's kit through 
Commodore. Having neither experience in 'C or Unix, we 
were rather dismayed at the absence of any alternative 
documentation supplied with the machine. The 

documentation appeared to have been written by the 
programmers for themselves. 

I read the Abasic manual in an hour Although it was heavy 
with information on common basic statements and functions, 
the machine specific graphics, sprite and sound information 
was lacking. After pages of description there v/ere only a 
few lines of code! 

One advantage that Commodore Amiga had over the 
Macintosh was its ability to be programed by the user from 
day one with good documentation. 

There were no national publications devoted to the Amiga 
programmer Here was a great tool with spectacular 
capabilities for all types of applications, yet we could not 
open it! 

If we were having this much trouble, chances were we were 
not alone. We turned to the Networks and watched the 
current chatter of users feeling their way through the same 
puzzles over and over. 

We decided a newsletter was in order. We felt the best way 
to reach Amiga users and sellers was through the 
Commodore Amiga dealerbase. At the end of September, I 
called Commodore to request a list of the Amiga dealers. I 
was told by a Commodore executive to "get the list from the 
Wall Street Journal Ad." 

With the tiny type list and a nine dollar zipcode book from 
the post office, we produced a data base of all dealers. By 
the first of December, we mailed (first class) a letter 
announcing Amazing Computing Newsletter and started 
receiving responses. 

We scoured the networks looking for people who wanted to 
share their hard fought knowledge of the Amiga. The 
response was thunderous. 

Due to the enthusiastic replies of users, and the assistance 
of a local printer, we moved from the concept of a newsletter 
to a full magazine. 

We offered the magazine directly to dealers for two reasons: 

1. The dealers were most In need of the type of Information 
that we wanted to supply. They needed the support for the 
machine. 

2. National distributors In the United States have 
established a system of distribution and schedule of 
payment that forces magazines to cover costs through 
advertisers. 
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The Amiga is a new machine that requires a great deal of 
good software to make it a viable market alternative to the 
prospective user. Atosf good and innovative software 
comes from small startup companies that can not support 
the high advertising costs of most major magazines. We 
decided to keep advertising costs as low as we could for as 
long as we could. This was a decision based on our own 
small size, we understand these risks. 

But, this does have Its problems. We are only alive due to 
the stores and dealers who will accept us. Each issue, we 
send a copy of our magazine to every Amiga dealer in the 
United States who is not among our current Amazing Dealers 
(Commodore supplied a list when they saw our first issue). 

Here in lies our tale. In the U.S. you can find Amazing 
Computing at Amazing Dealers who have accepted us. We 
have been nicked up bv many dealers who received 
requests from customers and users. . But, we can not sell to 
a dealer who will not pick us up. We have never "selected" a 
dealer, instead, we have made Amazing Computing as easy 
for a dealer to receive as pidiing up the phone. 

Although we have moved from our 9x12 office upstairs to our 
basement facility (we ship from the garage), we are still the 
same small organization. All the people who answer your 
mail or take your calls are family or friends. No one, except 
our Authors, has yet been paid by PiM. We exist on the hope 
and the promise of the Amiga and the Amiga user's 
enthusiasim. 

Don Hidis and the AC staff 



Gentlemen: 

I was just in Programs Plus (the Soulhcenter software outlet 
in Seattle, WA) and saw your magazine for sale. Having thie 
"Amiga Bug", I bought every issue of your magazine, 
Amazing Computing , that I cx)uld get my hands on I 

Thank you for finally coming out with an excellent monthly 
magazine devoted exclusively to the Amiga computer. 

Be ginner's Helpful Hint : 

I bought my Amiga (wrth 512 upgrade and 2nd disk drive) in 
November 1985. I also purchased the word processing 
program called Textcraft so I would have some functional 
software to utilize. Textcraft is an excellent beginner's word 
processing program, but being a legal word processor for the 
Boeing Company in Seattle, I immediately longed for 
something of a more professional nature. 1 finally found it in 
the form of Micro-Systems Software, Inc.'s SCRIBBLEI 
word processor. The following is my method of converting 
old Textcraft Kes to SCRIBBLE files: 

It's this simple - call up the files you want converted and 
store them using the " Text Only " format, then rename them 
using the extension ".doc" in your filename. You can then 
call them up in SCRIBBLE and they transfer across very 
clean; only minor editing needs to be done! II you do not 
use the "Text Only " format for storing, your file will not 
transfer across at all. 

Sincerely, 
Gerald W. Mahnke 
Seattle, WA 
Thank you for the Tip and the subscription. 



B mm INa^e Pi>intER.Va.fi:raivolowilz) 
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Need help wHh AmigaDOS? Have the CLI blues? 

DOSHelper - Provides help with all AmigaDOS commands just by typing 
'Help <command>' on your CL! screen. DOSHelper provides a 
template, full text explanation, options arxJ examples. No more 
fumbling with the manuals! A menu driven version with full 
Workt)ench support is also included for those just starting with CLI. 

SPOOLit - A print spooler that runs from your Ram: disk leaving you and 
your Amiga free for other tasks. Multiple files, page skipping, and 
date options included. 

All three for $23.95 + $2.00 shipping - with source code 
in C, and setup instructions included. NOT COPY PROTECTED. 

LifeStream 

P.O. Box 1332 

Kingston, Pa. 18704 

LifeStream 'A touch of focus for the mind Unbounded' 



Si 
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TheHSItoRGB 
Conversion Tool 

ByStephen R. Pietrowicz 

CIS: 73047,2313 

People Link: DrRitz 

Usenet: ...!ihnp4!pur-ee!gould!houligan!srp 



Color graphics are one of the Amiga's strongest 
attractions for new Amiga owners. Chances are, you 
have already begun to explore the Amiga's graphics, 
and written programs to show off your machine's color 
capabilities. 

However, one statement in Amiga Basic can be a bit 
cryptic: the PALETTE statement. The Amiga Basic 
manual explains that the PALETTE statement accepts 
four arguments, the color-id, and a decimal percentage 
of red, green, and blue (RGB), it even lists 16 colors 
with their RGB percentages. 

Suppose you want to draw a dark orange object on the 
screen. How do you decide what percentages to use 
to get that color? Through trial and error you might be 
able to get the color you want, but if you wanted to 
change the object's color, you would have to try and 
recalculate the percentages. 

You can use an alternate color system, hue, saturation, 
and intensity (HSI), to find the color you want to use, 
and then convert the HSI color coordinates to RGB 
coordinates. The program presented here does just 
that. 

First, I'll explain the HSI coordinate system. The hue 
coordinates are represented by the 360 degrees of a 
circle. Moving around the outer edge of the circle, 
colors change from red at degrees to green at 120 
degrees to blue at 240 degrees. Saturation changes 
by moving along the radius of the circle, and has a 
range from to 1 . 

A totally non-saturated color appears gray and has a 
saturation value of zero. Moving outward from the 
center along the radius of the circle will saturate the 
color. At the outer edge of the circle the saturation 
coordinate has a value of 1 and is fully saturated. 



Stretching the circle by pulling it's center out in 
opposite directions forms a double cone. 

The height of this double cone represents the 
intensity of the color and also has a range of to 1 . The 
bottom point of the double cone is blacl<, with a value 
of 0. Moving upwards towards the top point increases 
the intensity. 

The top point of the double cone is white, with value 1 . 
Choosing a color in the HSI coordinate system is simply 
a matter of rotating the circle to the color you want, 
deciding how saturated you want it, and then deciding 
how light or dark you want the colorto be. 

The simple HS! to RGB conversion tool listed below 
allows you to experiment with HSI coordinates and see 
how this color system works. When you choose HSI 
coordinates, their RGB equivalents are listed at the top 
of the screen. Those are the values you should use 
with the PALETTE in your own Amiga Basic programs. 

Use the mouse to change the HSI range indicators in 
each box. (You must increase the intensity and 
saturation coordinates above zero to begin to see 
colors). 

Try setting the hue to 240, the saturation to .50, and 
the intensity to .40. The box below the RGB 
coordinates should be dark blue. Increasing the 
saturation value will turn the dark blue to bright blue. 
Increasing the intensity will lighten the color, until at 
1 .00, it is completely white. 

When choosing your own colors, first select the hue in 
the range you wish to use, and then use the saturation 
and intensity value to narrow in on the coloryou want. 
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HSI Listing 

by Steven Pietrowicz 



' HSI to RGB Conversion Tool 
' By Stephen R. Pietrowicz 

SCREEN 1 ,640,200,4,2 

WINDOW 2,"HSI to RGB 

Conversion Tool By Stephen R. 

Pie{rowicz",,0,1 

DEFFNa{n) = 2-r((S*n)+.5) 

DEF FN b(n) = .5+(S-n)+2*(l-,5)*(.5- 

(S-n)) 

GOSUB Init 

Mouselnput: 
GOSUB PrinlVals 

' Wait for left mouse button to be 
clicked 

WHILE MOUSE(O) - : WEND 
X = M0USE(3)y = M0USE(4} 

' Check for box boundries 

IF (y < 100) OR (y > 1 80} THEN 
Mouselnput 

IF (x < 50) OR (x> 550) THEN 
Mouselnput 

' Hue Selected 

IF (y<= 130) THEN 
IF(x>=120)AND(x<=480) 
THEN 

Hue = (x-120) 
H = Hue/360 
COLOR 

LINE (hx,102)-(hx, 128) 
COLOR 1 

LINE(x,102)-{x,128) 
hx = x 
END IF 

'Saturation Selected 

ELSEIF(y>= 150) THEN 
IF(x<= 150} THEN 
S = (x-50)/100 
COLOR 

LINE(sx,152)-(sx,178) 
COLOR 1 

LINE(x.152)-(x,178) 
sx = x 



' Intensity Selected 

■ 

ELSEIF(x>= 450) THEN 

l = (x-450)/100 

COLOR 

LINE(ix,152)-(ix,178) 

COLOR 1 

LINE(x.152)-(x,178) 

ix = x 
END IF 
END IF 

GOSUB Convert 
GOTO Mouselnput 

Init: 
CLS 

COLORS 

UNE(118.100)-(482,130)„b 
LINE(48,150}-(152,180)„b 
LlNE(448,150)-(552,180)„b 
hx=120-.sx = 50:ix = 450 
COLOR 1 

LINE{tix,102)-(hx,12B) 
LINE(sx,152)-(sx,178) 
LlNE{ix,152)-(ix,178) 
COLOR 2 

LINE (50,25)-(550.75)„bf 
COLOR 1 

LINE (50,25}-(550,75)„b 
r = 0:g = 0:b = 0:S = 0:l = 
RETURN 



' Change given HSI coordinates to 
RGB 

Convert: 

IF H<. 16 THEN 

Red =1 

Green = H*6 

Blue =0 
ELSEIFH<.33THEN 

Red =2-H*6 

Green = 1 

Blue =0 
ELSEIFH<.5THEN 

Red =0 

Green = 1 

Blue =6'H-2 
ELSEIFH<.66THEN 

Red = 

Green = 4-H'6 

Blue = 1 



ELSEIFH<.83THEN 

Red =H*6-4 

Green = 

Blue = 1 
ELSE 

Red =1 

Green = 

Blue =6-6*H 
END IF 

Red = Red - .5 

Green = Green - ,5 
B1ue = Blue-.5 

IF (I <= .5) THEN 

Red =FNa(Red) 

Green = FN a(Green) 

Blue = FN a(Blue) 
ELSE 

Red =FNb(Red) 

Green = FN b(Green) 

Blue ==FNb(Blue) 
END IF 

IF Red > 1 THEN Red = 1 
IFGreen>1 THEN Red -1 
IF Blue > 1 THEN Red = 1 ] 
IF Red <0 THEN Red = 
IF Green < THEN Green = 
IF Blue <0 THEN Blue = 

PALETTE 2,Red.Green.Blue 
RETURN 

PrintVals: 

COLORS 

LOCATE 2,22 

PRINT USING "Red =#.## 
";Red; 

PRINT USING "Green = #.## 
";Green; 

PRINT USING "Blue =#,#r;Blue 

LOCATE 12, 34 

PRINT USING "Hue = ##r;Hue 

LOCATE 1 8, 5 

PRINT USING "Saturation = 
#.##";S 

LOCATE 18, 55 

PRINT USING "Intensity = #.##";! 

COLOR 2 
RETURN 

•AC- 



Amazing Computing 



TM 



Page 




2 Megabyte Ram Board For The Amiga PC 



Comspec Communications Inc. Is proud to announce an exciting new product. The 
MICROSHARE AX 2000 - a 2 megabyte ran board for the Commodore Amiga PC. 

The ablbty of the AX 2000 to Incorporate 2 megabytes of ram and allow the user growth 
potential by the cascading of additional AX 2000s, now gives the Amiga PC vastly extended 
computing power. 

Mounting on the right hajid aide of the Amiga PC the AX 2000 connects to the expansion port. 
Additional peripherals which would normally be connected to the expansion port can then be 
connected on the expansion port of the AX 2000. Standard expansion bus architecture was used 
In the design of the AX 2000, thereby Insuring compatibility with all peripherals. 

The AX 2000 can be used to Increase ra.m memory, or as a fast ram drive. When used to 
Increase ram memory the AX 2000 will greatly enhance the multl— tasking feature of the Amiga 
PC. With more memory available to the system It Is possible to have more tasks running 
simultaneously or a greater amount of memory available to each of the tasks. Software 
developers will find the AX 2000 a must, allowing a great reduction In compile/assembly time, 
thus leading to a real savings in terms of development costs. 

The MICROSHARE AX 2000 Is available from stock, for Immediate delivery. 



Suggested Retail Price : Canadian $1200.00 Cdn Funds (+ 12% FST as applicable) 

U.S. $899.00 U.S. Funds (F.O.B. Toronto) 

Dealer Enquiries Invited 

For further Information contact: Comspec Communications Inc. 

163 Bridgeland Ave., Unit 5 
Toronto, Ontario M6A 2Y6 
(416)-787-0617 

Amiga is a registered trademark of Commodore Business Machines 
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AMIGANOTES 

By Rick Rae 

CIS 72177,3516 

People Link "watch this space". 



INTRODUCTION 

So here I am, sitting in Ihe office after hours, keyboard 
straddled across my lap, groping ior a way to begin my first 
column for Amazing Computing. Part of the problem is 
distraction: I keep thinking of all the things I should be 
doing. I can barely fulfill my current obligations... why 
should I take on another responsibility? 

The answer goes beyond the incredible potential of the 
Amiga architecture and my interest in seeing it succeed. It 
can be found, instead, in my desire to give equal time to what 
1 consider a slighted application area: sound and music. 

Certainly there have been articles on computer music, and in 
fact there are one or two publications devoted to it. Taking 
the computer publishing industry as a whole, however, the 
majority of the effort is spent elsewhere. 

Word processors, spread sheets, data base managers, 
graphics... music seems to take a back seat to them all, 
which is a pity. 

Almost everyone enjoys some flavor of music; even those of 
us who cannot play a note or carry a tune listen to the radio. 
So, I want to play my small part in bringing you music- 
oriented information. 



WHAT THIS COLUMN WILL BE 

The Amiga is well suited to many audio applications. Several 
manufacturers realize this, and are already hard at work on 
new products, some available even now. I want to pass 
along as much information on these products as possible. 

For example, there are four audio digitizers of widely varying 
price which will be available shortly. Which has the best 
signal-to-noise ratio? Are they all stereo? Which is best for 
your application? 

I intend to give you a rundown of the pros, cons, and 
features of all three so you can choose wisely. 

Product reviews will be balanced with other topics. 
Explanations of various synthesis methods, the physics of 
sound, how to mimic various instruments... these are all 
fertile areas to explore. 

I hope to interview some of the key people in the Amiga audio 
field, giving us all an insight into why their products work as 
they do. I expect the manufacturers will keep Amazing 
Computing informed as to future products and release dates; 
we will be passing what we have along to you as well. 



And, most importantly, I am interested in what _you_ are 
doing. This is your column. If you have an interesting sound 
program in BASIC, C, assembler or whatever, send it in. If 
you have found an Amiga audio product you really love or 
hate, tell us about it. 

Disagree with something I have said? Take exception and 
let's discuss it. Like to see us cover your favorite topic? 
Let me know! Don't be afraid to write; this is going to be an 
informal column and I want it to be a vehicle through which 
we can all share. 

Online questions 

Finally, I will try to field questions. Realize that I am not an 
expert in the audio field, and certainly not where the Amiga is 
concerned. I am, however, an engineer and programmer who 
has been involved in electronic musicfor many years. 

It never hurts to ask; just drop me some electronic mail and 
let's see what we can come up with. 

I am a subscriber to CompuServe and People Link. You may 
either send me electronic mail, or leave a message on the 
forum bulletin board. My CompuServe ID ID number is 
72177,3516, on People Link, contact AMICUS and John 
Foust will forward it to me. 

H you are not a CompuServe or People Link subscriber, you 
will need to fall back on the postal sen/ice; send your letters 
to PiM Publications to my attention. Let's hearfrom you! 



DIGITAL AUDIO 

If everything goes as scheduled, I should have my hands on 
at least one audio digitizer in time for a review In next 
month's column. In preparation for this, let's talk a bit about 
digital audio. 

Sound is created when an object displaces air or another 
medium and changes its pressure at a rate which falls within 
the audible range. 

Traditional musical instruments create sound with vibrating 
surfaces: the strings of a violin, the reed of a clarinet, the 
lips of a trumpet player, the head of a drum, and so on. 

This vibration results in a more or less cyclic change in air 
pressure which causes movement of the eardrum, a 
membrane in the ear. Nerves connected to the eardrum 
create electrical impulses which the brain interprets as 
sound _ 
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GANDER SOFTWARE, IJDJ /(j 
"11 Flies" "^ ^ 

TIME a TASK 
. ... PLANNER''' 



For Each of 5 Users: 
To Do List 
Future Plans 
Appointment Schedule 
5-Days-At-A-Glance 
Calenders 
Runs from its own CLI, 

or workbench{floppy of Hard) 

Price $1 00.00 w/o ABasic, $1 1 0.00 w/ABasic 

Gander Software Ltd. 
3223 Bross Road 
The Ponds 
Hastings, Mi 49058 
Tel. (616)945-2821 

Requires: 51 2K Amiga; two disk drives; Amiga-DOS 1.1; ABasic 



Edison discovered long ago that by reproducing these 
pressure variations, one could recreate the sound which 
originally caused them. 

His first approach was to physically record an analog of 
these variations: a moving cone, caused to vibrate by 
changes in air pressure, scribed a groove onto a rotating 
cylinder. The same cone, when later driven by that cylinder, 
recreated the original sound. 

This system was fully mechanical in nature, but the same 
end can be achieved electrically by using different types of 
transducers. A microphone converts variations in air 
pressure to a corresponding variable voltage. 

A speaker then converts this same varying voltage back into 
variations in air pressure, and voila, we have our original 
sound back. With the high tech stereo gear available today, 
you might think this is overly simplified, but not by much. 

It is in fact possible to connect certain speakers together 
directly and use them as an ersatz intercom, with sound as 
the oniy power source. Generally, however, there will be 
something between input and output. 

Without a storage medium, we have here the basis for real- 
time audio communications like telephone and radio. By 
adding storage we can delay the reproduction of the sound 
to a later date. Record players and tape decks are, of 
course, two methods of storage and time delay. 



Computer Audio 

All these systems have one thing in common: the 
transmission or storage of exact analogs of the original 
variations in air pressure. Compact Disks and digital audio 
introduce a new element: the computer. 

Since digital circuitry does not understand about the real 
world, we must convert our varying voltages into digital form 
before the computer can deal with them. This Is the function 
of the Analog to Digital Converter [NO). 

Simply stated, an A/D quantizes an anabg signal into 
discrete steps over a given range. As an example, let's 
assume an 8 bit A/D with a 5 volt maximum input. 8 bits 
gives us 2'^8 or 256 possible step values, and distributing 
these over the 5 volt range results in a 5/255 or .0196 volt 
step size. 

(One step is lost because the last transition occurs at 
exactly 5 volts. Some would argue that there are in fact 256 
steps; this is a matter of interpretation.) 

The A/D converts the analog input signal into a digital output 
which represents the input as closely as possible with 
multiples of .0196 volts. If our input was 1/2 voil, the A/D 
would output 25, which is the closest we can get: 
25*.01 96=0.49 volts. 

At this point our signal is in digital form and we can store it, 
transmit it, or generally do whatever we can imagine to it with 
a computer. When we are ready to send the signal back to 
the real world we must once again modify it, this lime with a 
Digital to Analog Converter (D/A). 

A D/A basically performs the opposite function of an A/D: it 
takes as its input digital data and converts it to an analog 
representation. Since the input to the A/D is in discrete 
steps, its output will be also. Using the example above, the 
output of our D/A will be changing in .01 96 volt steps. 



Bits and audio 

We now have a method for inserting a computer into the 
signal path between microphone and speaker, but 
unfortunately all is not sweetness and light. It is obvious 
that the amplitude domain of our system is no! continuous, 
since it jumps from step to step. 

The more bits we have, the finer the steps and the more 
faithfully the output represents the original signal. Using the 
5 volt example above, if we upgraded to a 12 bit converter 
each step would be 5/(2''12-1) or .00122 volts; with 16 bits 
we'd get an incredible 5/(2^16-1) or .000076 volts! But what 
does this additional resolution buy us? 

Since we know we can reproduce a sound by recreating the 
air pressure variations associated with it, it should be 
obvious that making any change in those variations will 
affect the sound. 

Quantizing the amplitude with our A/D and D/A conversions 
can affect the sound in more ways than one, but for now we 
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will concern ourselves only with Signal to Noise Ratio (S/N). 
This is simply a measurement, in decibels, of the signal 
amplitude relative to the amplitude of "everything else". 

The more bits we have available to represent our signal, the 
better the S/N ratio (and sound quality) will be. The following 
table relates S/N ratios to various word widths. Since many 
of us don't have a feel for decibel ratios, I have included 
some rough comparisons which should help a bit. 

BITS S/N(db) TYPICAL EXAMPLES 



Portable Cassette Player 

High Fidelity Cassette Deck 

Cassette with Dolby B, Open Reel, Phonograph 

Mastering Recorder 

"Live" Sound, Cassette with dbx 

"Live" Sound, CD Player 



If you are Interested in calculating the S/N ratio for other 
word widths, the formula is 6n+4 db, where "n" is the number 
of bits. Be aware that this is the theoretical maximum value; 
for most realistic purposes you can simply use 6n db. 

As has been explained, amplitude quantization can affect 
the quality of our digitized audio. What hasn't been 
mentioned yet is that we have a similar problem with the time 
domain. 



6 


40 


8 


52 


10 


64 


12 


76 


14 


88 


16 


100 



Sampling rate 

Our original analog voltage varied continuously, but no 
matter how quickly we pull data out of the A/D it will still be 
coming out a chunk at a time. We will also be passing the 
D/A its data in discrete units. 

Thus the quantization which we saw in the amplitude domain 
(which restricted values to multiples of the smallest step) 
also exists in the time domain (which restricts us to changing 
values in multiples of the sampling rate). 

Where sampling rate hurts us is in frequency response. The 
frequency of a signal is directly related to how many cycles 
occur per unit of time (frequency is measured in Hertz (Hz), 
which is equivalent to cycles per second). 

A mathematical concept called the Nyquist Theorem states 
that the sampling rate must be no less than twice the 
frequency to be sampled or reproduced. 

From this we might assume that sampling a 1 KHz signal at 2 
KHz would be safe, but not necessarily. With the exception 
of the sine wave, all sounds are composed of numerous 
frequencies, most of which are higher than the pitch we 
perceive. 

These higher frequencies would violate the Nyquist 
conditions and result in aliasing : a "folding" of frequencies 
which is both quite obvious and obnoxious. The solution is 
either to sample at a higher rate or to filter out these higher 
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— AMIGA OWNERS - 

IMAGINE A STORE BUILT AROUND THE AMIGA 
IT'S HERE NOW ! 
THE MEMORY LOCATION 
3 «? lb WASHINGTON STREET CRT 
WELLESLEY, MA 021B1 
<bl"7 - 237 - <»>B4i. 
JUST A FEW DOORS UP FROM THE PLAYHOUSE 
FEATURING THE LATEST AND THE GREATEST FOR AMIGA 
WHAT DO WE HAVE? 
FINANCIAL PLUS INFO BASE LATTICE C ZORK I 
DELUXE PAINT MASTERTYPE MOUSTERPIECE PAL 
FINANCIAL COOKBOOK BRATTACUS HACKER FOURTH 
SEVEN CITIES OF GOLD ONE ON ONE MARAUDER 
TALKING COLORING BOOK ANALYZE! TEXTCRAFT 
AEGIS ANIMATOR ZORK II AEGIS IMAGES LISP 
MONKEY BUSINESS FORTRAN 77 SPELLBREAKER 
AZTEC C SCRIBBLE ZORK III DIGITAL LINK 
RACTOR ARCHON GI5M0Z CUSTOM PRINT DRIVERS 
AMIGA DOS MANUAL (BANTAM) KID TALK BBS-PC 
TYCHON UTILITIES PAK-A-DISK MOUSE MATS 
ON-LINE AMIGA HANDBOOK (SUNSHINE) FLOW 
MOUSTERPIECE HALLEY ' S PROJECT PASCAL 
GRAPHICRAFT UBZ FOURTH ARCTIC FOX A-TIME 
PAR-HOME CABLES MINDSHADOW MUSIC STUDIO 
BORROWED TIME DISCOVERY SPELLCRAFT TxED 
TALKING TRIVIA DIGI-VIEW META-PASCAL 
MODULA II DEVELOPERS + COMMER. SPELLER BEE 
ELEMENTARY AMIGA BASIC BOOK INFOMINDER 
BEGINNERS GUIDE TO AMIGA WRITE HAND 
AMIGA CROSS DEVELOPMENT ENVIRONMENT FOR IBM 
MIND FOREVER VOYAGING BUSINESS STATISTICS 
TYPING TUTOR + WORD INVADERS WRITE HAND 
AVETEX 1200 MODEM EXPERIMENTAL STATISTICS 
MIAMI6A SALES FORCASTING VIP PRO. MIRROR 
PENMOUSE + SERIES ONE TABLETS MAXIPLAN 
ONE MEG RAM EXPANDER INFOMINDER FISHDISKS 
AMICUS DISKS DYNAMIC-CAD GOLDEN HAWK MIDI 
MIMETICS SOFTWARE, MIDI, DIGITIZER DISCOVERY 
GOLDEN OLDIES MODEMS DKIMATE 20 PRINTER 
AMAZING COMPUTING AMIGA WORLD TRANSACTOR 
CANON COLOR INK JET AND DRIVER JUMPSTART 
SOFTWARE RENTAL CLUB CONSIGNMENT SALES 

AND MORE ! ' < 
A BETTER QUESTION WOULD 
"WHAT DON'T WE HAVE?" 
ONLY WHAT WORKS, SATISFACTION GUARANTEED 



BE 



components. 

So we have two primary parameters by which to judge a 
digital audio system: word width and sampling rate. As 
always, there are tradeoffs involved. A wide word (say 14 or 
16 bits) can give us the ability to reproduce sounds 
indistinguishable from the original, but at what price? 

Higher resolution converters, both A/D and D/A, are 
expensive; A/Ds which resolve more bits are slower than 
smaller A/Ds (this has an impact on sampling rate); for 
systems which store data, more memory is required for wider 
words. 

A high sampling rate (50 KHz, for example) allows us to 
capture and reproduce the complete audio spectrum with 
simple guard filters, but again we pay. 

Higher system throughput and high speed converters 
translate to more expense; more memory will be required to 
store the digital information. 



Amiga sound 

Understanding the basics of digital audio, let's take a quick 
look at what we need to implement a system using the 
Amiga. Fortunately, a lot of the requirements have been met 
by hardware and software already "under the hood". 
Between the custom sound chip and the 68000, high 
throughput is not a serious issue. 

The Amiga has four 8 bit D/A converters built in, each with 
it's own 6 bit volume control. Although this would seem to 
limit the S/N ratio somewhat, games can be played with the 
volume control bits to improve the quality over what we would 
get from a stock 8 bit converter. It is possible to pair the 
converters together to get much higher resolution and better 
sound quality in two channels. 

The only thing we are really lacking, in fact, is the A/D 
support, which is the core of the audio digitizers soon to be 
released. We will be taking a look at these digitizers in detail 
as they come in over the next few months. 



IN CLOSING 

This is an exciting lime to be involved with electronic music. 
The Amiga offers tremendous potential as yet untapped. 

MIDI, the Musical Instrument Digital Interface, still in it's 
commercial infancy, is just beginning to take off in 
popularity. 

Yamaha has opened the floodgates to a new synthesis 
technology with FM sounds, Korg has blended sampled 
sounds and traditional analog technology into an affordable 
hybrid. Casio, Ensoniq and a host of others are bringing 
different approaches to the masses at unheard of prices. 

It goes on and on, and we are in the midst of it, or can be. Ail 
we have to do is open our eyes. And our ears. 



Nybbles, 
Rick 
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AT COMDEX 




The Sidecar, closely mated 1o an Amiga, with an extra 3 1/2 dislt drive on top. 
The Sidecar is about an inch taller than the Amiga system unit. 



Sidecar A First Look 

by JohnFoust 



The Sidecar is a hybrid machine that unites the Amiga and 
IBM PC computers. It provides complete IBM PC compatibility 
for the Amiga, with a 5 1/4 disk drive, three PC-compatible 
card slots, 256K of onboard RAM, and a numeric coprocessor 
socket. 

The Sidecar stands an inch taller than the Amiga system unit. 
It mates directly to the side of the Amiga, to both the system 
bus and the joystick connectors. It is not a system bus pass- 
through, so it must be the last peripheral device connected to 
the Amiga bus connector. 

The Sidecar has a single internal slot for an optional Amiga 
memory expansion board, in 2 megabyte or 8 megabyte sizes. 
For IBM memory expansion, it has empty sockets for 256K 
more RAM on the motherboard. 

Sidecar has an expected retail price of about $650. 
Commodore representatives said it should be available in late 
summer or early fall. Dealers should have demo Sidecars in 
mid-summer, as 1500 pre-production models were expected 
to arrive in early June. 

The Amiga continues to work as usual while attached to the 
Sidecar; it does not harm the multiprocessing capabilities of 
the Amiga. The PC video display appears as a window or 
screen on the Amiga display. 

However, the Sidecar requires a special Amiga program to 
run, so this interface software takes up some Amiga memory 
space. 



At the introduction of the Sidecar at COMDEX Spring in 
Atlanta, Commodore privately encouraged IBM PC hardware 
and software developers to test the Sidecar for IBM PC 
compatibility. 

All comers succeeded, including a hardware developer who 
reported his product would not run on many PC clones. "Most 
of the compatibles crashed with his system," according to an 
engineer who helped design the Sidecar. The popularity of the 
PC-10 and PC-20 in Europe also attests to the full 
compatibility of the Sidecar. 



Hard disk expansion 

The floor model of the Sidecar had a 20 megabyte hard disk 
card installed in one of the slots. This drive can be partitioned 
for use under both operating systems simultaneously. Each 
operating system can access the resources of the other. For 
example, it is possible to share PC-DOS files with AmigaDOS 
programs, and vice versa. 

The Sidecar with a hard disk card offers the most economical 
path towards a hard disk for the Amiga. "Hard card" disk 
drives of this type are commonly available for about $500, for 
1 and 20 megabyte versions. 

Multifunction IBM cards could add more IBM memory, serial 
and parallel ports, a battery-backed clock, a modem and more 
on a single card, starting at $150. Conceivably, these 
resources could be used by Amiga programs, as well. 
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Torsten Burgaortf, an engineef from the West 
Gerfnan team tha! produced the Sidecar. Burgdorfl 
was responsible for much of tha Sidecar side ot the 
$ollware interlace. 



If you have an Amiga 5 1/4 disk drive, 
you can stiil use it with the Sidecar, 
since it has the standard daisy-chain 
disk drive connector on the back. 



Resource sharing 

The Sidecar and Amiga share 
resources, so the Sidecar does not 
have its own keytoard, video 
circuitry, or parallel and serial ports. 
(Of course, an additional IBM card 
could provide more ports.) 

Extra graphics cards are not 
necessary with the Sidecar. It 
emulates both IBf^ monochrome and 
color graphics using the Amiga video 
circuitry. 

Monochrome windows reside on the 
Workbench screen. Color windows 
reside on a separate pull-down screen, 
in 640 X 200 resolution. One 
monochrome window and one color 
screen can be present at once. 
However, only one can be selected to 
run at a time. The sixteen colors 
available under IBM color graphics can 
be adjusted with a Sidecar Preference 
program, using a palette gadget. 

To begin with, both types of windows 
are resizable. The Intuition gadgets 
scroll bars take up space on the 
screen, but if you double-click inside 
the window, the Amiga window borders 
disappear, and standard 24 lines by 80 
columns are available to the IBM 
program. 

The video interface between the Amiga 
and the Sidecar depends on 128 K of 
dual-ported video RAM. When the PC 
program changes anything in on its 



screen, the video memory is changed. 
The Amiga gets an interrupt, and can 
decide whether to update the PC 
screen on the Amiga display. 

If it chooses to update the screen, the 
image in the Sidecar video memory is 
quickly transferred to the Amiga video 
memory, using the blitter. The priority 
of this update is selectable with the 
Sidecar preferences. 

Made In Germany 

The Sidecar was developed by the 
engineers at Commodore Business 
Machines in Braunschweig, West 
Germany. It is based on the 
successful design of Commodore's 
PC-10 and PC-20, Commodore's IBM 
PC compatible computers. Many 
Sidecar engineers were instrumental in 
the development of both machines. 
The PC-10 and PC-20 were formerly 
sold only in Europe and Canada, but 
recently. Commodore began marketing 
them in the U.S. 



Janus and Zaphod 

The German engineering team adopted 
the code-name "Janus'* for the Sidecar 
project, after the Roman god. Janus 
had two faces. His name gives us the 
month "January". 

According to CompuServe Amiga 
Forum member Jim Ventola, Janus was 
the first Roman state god, and that the 




Gail W^eliington, from Commodore international marketing, demonstrates the 
Sidecar to an omnipresent crowd. An extra 3 1/2 disk drive sits atop the 
Sidecar. 



The interior of the S idecar, with the 5 1 M disk drive in place. 
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A rear view ol a partially disassemblad Sidecar, with the 5 1/4 disk drive in 
place. The power supplies and muUin Ian are at the back of the Sidecar, The 
three IBM card faceplate holes are at (he lower right. An extra disk drive 
conneclof is lying next to the DB-23 connector at the right edge of the picture, 
at the back of the Sidecar, 



The Sidecar, facing the camera, with the 5 1/4 disk drive removed and placed 
off to the left. The circuit board in the center of the picture is normally below 
the disk drive, and the disk drive power connectors are at Ihe top of the 
picture. In Ihe middle of the center circuit board, to the left, is the Amiga 
system bus connector. The 2 meg and 8 meg RAM expansion boards install 
on this connector, between the disk drive and this circuit board. Along the left 
edge, and towards the bottom of the picture, are the two DB-9 joystck/mouse 
connectors. This edge mates with the Amiga system unit. 



ptoper sacrifice for Janus was a ram. However, RJ M\ca\ 
called the Sidecar "Zaphod", after tfie character from tfie book 
"The Hitchhiker's Guide to the Galaxy." In the book, Zaphod 
Beeblebrox has two heads. They constantly argue with each 
other, 

f\4ical left Commodore-Amiga in January, He was the primary 
author of Intuition, the windowed user interface on the Amiga. 
When the Sidecar engineering team needed software for the 
Sidecar, they sought RJ Mical. For more discussion of Micai's 
involvement with the Sidecar, see his interview elsewhere in 
this issue. 

The German engineers developed the Sidecar on their own. 
"We were free to design it. No one said This is the way to do 
it,'" according to Frank Ullmann, a hardware engineer on the 
German team. "It was easy." Ullmann had done similar work 
for his master's degree. "There should be no 
incompatibilities," he said. 

Starting with the PC-10 motherboard design, they removed 
the interlace circuitry for the parallel printer, the serial port, 
and the keyboard, and made the changes for the switch from 
5 1/4 drives to3 1/2drives. 

The number of IBM card slots is still pending, Ullmann said. 
Also, some of the circuitry will be reduced to custom gaJe 
array chips in later production. "It was a very new style of 
programming, a multitasking I/O driver," according to Torslen 
Burgdorff, a software engineer. Burgdorff and Ullmann were 
present at COMDEX, escorting the Sidecar prototypes 
through customs. The first molded plastic cases arrived just 
in time for the show. 

They tested the first 8 megabyte RAM card for the Sidecar 
minutes before packing them for COMDEX. The prototype 
board used new Tosfiiba 1 megabit RAM chips. The 2 
megabyte board uses 256K chips, so both designs use have 
64 sockets on the optional memory board. 
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This view of the Sidecar motherboard clearly shows the standard 256K RAf^, 
and the filled sockets for Ihe additional (but optional) 256K RMJ\ expansion. 
The S 1/4 disk drive woufd test above the circuit board at she top of the 
picture, mounted at one edge by the bracket at left. This circuit board is 
connected to Ihe motherboard by two ribbon cables. 

The slickered top of the BIOS ROM chip is visible between the eighteen RAM 
chips and the left ribbon cable. 

The three IBM-compatible card slots are at Ihe right edge of the picture, 
towards the back ol the Sidecar. 



Sidecar VS. Transformer: Computers in Disguise 

The current path to IBM compatibility is the Transformer 
program, a software emulation of the \BM computer. It is 
currentfy bundled with the 5 1/4 disk drive available for the 
Amiga. 

The Transformer, made by Simile Research, of Centerport, 
New York, interprets the 8088 microprocessor instructions in 
an IBM program, and mimics their functions with a program 
written for the 68000 microprocessor in the Amiga. This 
process is slow, but for many applications, speed is not a 
limiting factor. 
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At one point, Commodore announced a hardware accelerator 
for the software Transformer, but this project has been 
shelved, according to Simile Research marketing director 
Doug Wyman. This was to be a set of custom logic chips that 
accelerated the translation of 8088 instructions to 68000 
instructions. 

For more infofmation on the Transformer, and Wyman's 
reaction to the Sidecar introduction, see his interview 
elsewhere in this issue. 



The German Sidecar engineering team can be reached at: 
Commodore Buromaschinen GmbH Ernst-Amme-Str. 24-25 
3300 Braunschweig, West Germany 

Telephone (0531) 55051 Telex 952 518 como d Fax (0531) 50 
80 88 




The rear of the Sidecar. The power switch and extra AC power plug are at 
upper fight. The daisy-chain disk drive DB-23 connector is at lower right, and 
the faceplates lor \BM cards are a! left. The muiiin Ian is al cenier. 
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Hmazing Computing 

Next Month: User Groups! 



Finally, a programming environment that's 

been designed specifically for the Amiga..™ J. 

Multi-Forth™ for the Amiga. ^^ 

Multi-Forth is a new language which was designed to unleash the full power of the 
Amiga. Multi-Forth provides complete access to all Amiga libraiies including 
Intuition. It compiles stand-alone applications in seconds (other languages typically 
take several minutes). There are no royalties, and no "levels." CSI provides the best 
support of any computer language vendor, including CSI technical hot Hne, our own 
CompuServe net (GO FORTH), and comprehensive documentation. Programming 
the amazing Amiga is interactive and fun with Multi-Forth. Contact us for a technical 
data sheet with the complete hst of Multi-Forth's features. 

Simply the best programming 
environment for the Amiga. 
$179 Introductory price. 

Mulii-Forth is a trademark of Creative Solutions. Inc. 
Amiga is a trademark of Commodore-Amiga, Inc. 



Creative Solutions, Inc. 

4701 Randolph Road Suite 12 
Rockville.MD 20852 
(301) 984-0262 in MD or 
1-800-FORTHOK 



Xi«<tm «««a s cmKtmnKmm«timmsaxsmma^^ 
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At COMDEX 




John Foust talks with RJ Mical 



RJ Mical (his last name is pronounced 
as "Michael") wrote most of Intuition, 
the windowing interiace on the Amiga. 
In this interview, he discusses 
technical details of the Sidecar, along 
with some of the problems they 
encountered in its development, and 
why Intuition isn't hard to program. 

Mical's comments are prefaced with 
"RJ:". The comments within the 
transcript are mine. 

JF: Did you work in Germany, or where 
did you meet them? 

RJ: Well, they first brought a 
prototype of it out here in the end of 
January, beginning of February, 
something like that. It was wonderful, 
because it was a PC talking through an 
Amiga window. What they really had 
done was the hardware interface part 
of it, but they didn't have any of the 
software, and their software cheated 
like mad. It sat there and didn't do 
anything else but look at the hardware 
and see if anything had changed, and 



it didn't use the multitasking, and it 
didn't use any of the system 
functions, and stuff like this. They 
realized if they v/ere going to have a 
viable product, they needed to get 
some people who really understood the 
Amiga to lay the software down for 
them. The guy that came out to do the 
serious recruiting for the project was 
Rudolph Goedecke. "Herr Doctor 
Goedecke", he's a real nice guy. Much 
to his dismay he found when he got 
there that I was no longer an 
employee. I don't know \i you know, 
but I'm not an employee of 
Commodore. 

JF: When did you leave? 

RJ: It was in January. He came out 
and got in touch with me at home, and 
asked me if I would go out to Germany. 
It was a real interesting job, because it 
was relatively easy, or within reason, I 
mean, to get the basics done, to get 
enough of the software together where 
the PC could exist in an Amiga 
window. That part was relatively easy. 



From the very beginning we set our 
sights as high as we could. It wasn't 
just the simple matter of a PC talking to 
an Amiga window. We were actually 
going after creating a hybrid machine, 
where the two of them could co-exist, 
one could be a coprocessor for the 
other. 

JF: Thus the name "Janus." 

RJ: Yeah, Or "Zaphod" is my name for 
the project. 

JF: That would make a little more 
sense to the non-classics majors. 

RJ: I'm not exactly sure. Are you a 
classics major? 

JF: No. 

RJ: Well, I'm not either. But I have the 

impression that Janus was not an 
altogether savory character. So I've 
resisted that code-name all along. I 
wanted to use some code name, so I 
cameup with my own. "Zaphod". When 
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it iirst started, it was very appropriate, 
il was like the two heads are 
constantly bickering with one another. 
That's what it was like when we first put 
the two of them together, it was a lot of 
fun. It was a good name for me. In 
fact, everywhere in my source, this 
was the code name I used. We've set 
it up so that the two of Ihem do co- 
exist. The PC is a normal old PC, but 
instead of writing to its display 
memory, it writes to the dual-ported 
memory that my software can access, 
not just my software, but anyone's 
software, that uses this interface 
mechanism that we've created. 
The interface mechanism is entirely bi- 
directional and completely flexible, so 
you can ask either processor to do 
something for you. 

For instance, one of the demos I 
wanted to get together in time for 
COMDEX, but I spent all my energy 
just working on the display stuff, was a 
Mandelbrot program. Have you seen 
this? One of the demos we wanted to 
put together was to have a Sidecar 
with a 8087 math processor. 

I'd really love to write some stuff. The 
thing that I'm most interested in these 
days, is there is a general dread, I 
understand, in the programmer 
community, that the Amiga is too 
complicated to program for, it's too 
difficult, it's too immense. It is in fact, 
in many respects, a minicomputer 
compacted down into a 

microprocessor frame. But it doesn't 
have to be that scary, it's not that 
difficult. The documentation isn't 
there. The good books aren't there 
yet, the one that says to you, "Come 
here, now look, it's nice, it's easy, it's 
not that scary, come here." This is the 
stuff I'm on about these days. I'm 
going out to user groups a lot, and I 
gave this one talk about the Executive 
and message passing. 

JF: You were at a FAUG meeting, 
right? 

RJ: Yes. I was at one of them. I've 
done several things like this. I would 
like to write a book, i don't know if I'm 
going to have time. I'm talking to 
Commodore about putting together a 
collection of routines, and 
documentation describing it, but 
mostly to show people that they don't 
have to be intimidated by this stuff. 



It's all very accessible, you don't have 
to be a great computer scientist to 
understand this stuff. It's all within 
every programmer's reach. It's just a 
matter of understanding the bigger 
picture better - which a lot of people 
don't have yet - to not be scared by a 
lot of the stuff that's presented as 
excessively systemy. I went out of my 
way when I wrote Intuition to give 
names that were fun, that were 
friendly. I hate to use the word 
"friendly", it's over-used. 

JF: Like the AM IGA_F I REWORKS 
display? 




RJ: I'm glad you read your Intuition 
manual. Like the unfortunately-named 
"GimmeZeroZero," which even I've 
come to hate now, because it's so long 
to type. You know -dah dum dah dum 
dah dum. Like "gadgets." I don't 
remember some of the other things 
that people said - "You don't want to 
call it a 'gadget", you should call it 
this." No! It's a gadget! It's a fun 
name. Every guy wants to write a 
program, and goof around with 
gadgets. 

This is my main theme, to help people 
feel more at ease with the entire 
environment. I don't think it is very 



intimidating. You have to be a good 
programmer to program for the 
machine, but you don't have to be a 
computer scientist. There is a big 
distinction between the two of those. 

JF: I just realized what I wanted to do 
with your picture in the magazine. I 
want to put an equals sign and a minus 
on each side of your head. 
[In many source code examples 
distributed to developers, in the top of 
the text with the programmer's credits, 
RJ wrote his name: -=RJ Micat- with 
minus and equal signs on both sides. 
His hand-written signature is similar.] 

RJ: God, this has been a trademark 
for years. It started out years ago... 
Well, it's a long story. It's become 
such a repeated thing with me now, 
and I didn't really want to become 
identified with it, but I find myself being 
identified with it. They new about it in 
Germany before 1 got there, and they 
had this thing made up for me with 
equals signs on it. 

JF: Back to how both machines can 
access each other's memory. 

RJ: That's right, I was telling you 
about Mandelbrot. Mandelbrot is a real 
nifty program, and the pictures that it 
creates are really cool, but it takes a 
long time to do. If you do it without 
floating point, it gets cumbersome, or 
if you do it with integers, you lose 
some of the resolution. You could 
probably do it with a fixed-point long. 
This is one of the projects I wanted to 
go after, because it pertains to some 
other projects I wanted to work on, 
and I wanted to do some fixed-point 
math routines. 

JF: I heard Ward Christensen was 
working on Mandelbrot wallpaper, in 
Tufbo Pascal on the PC. 

RJ: My dream with Mandelbrot is to 
control it with a joystick, so you could 
zoom over the surface in real time, and 
dive in. I figured out the quantum 
leaps in calculation that would be 
required... Not with today's 

technology. Maybe with a Cray. 

One of the demos we were going to put 
together, was to show the Mandelbrot 
program as it exists today, not with the 
shortcuts or anything, (but) with the 
floating point, and do the same thing 
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using the sidecar, where the 
Mandelbrot program would run on the 
Amiga, but instead of doing the math 
calculations for the innermost loop 
that derives the quantum for a point, it 
would instead be able to call the PC, 
and say, "Here's the current 
coordinates, do the routine for me." 
The PC would use its 8087 to do the 
calculation for that point in a Hash, 
and give it back then, giving it back 
using that communication link Ihat we 
have set up between the sidecar and 
the Amiga. We were looking at an 
increase in speed of at least a factor of 
ten. A factor of ten is dramatic, 
because some of the more intricate 
pictures can take six hours to draw. If 
you're talking about the difference 
between thirty-six minutes and six 
hours, it's a lot better. 

JF: Can they view each other's 
memory? 

RJ: Not directly. But there is a facility 
we've created where either processor 
can ask lo see a chunk of memory in 
the other. We've got a 128 K dual 
ported. They've set up a signal-locking 
mechanism where they can gain 
access to that memory and lock each 
other out, and we've created a little 
memory manager that goes in there 
and allows you to allocate chunks of 
that memory, and use it tor 
communications, use it for message 
passing, use it for accessing the hard 
disk by setting up a buffer. You can 
then say to the PC "Read this 
information off the hard disk, into this 
buffer," Since it's memory that you 
can access from the 68000 
processor, you're getting hard disk 
speeds. 

JF: A lot of people are wondering 
about documentatbn for all this. 

RJ: We're doing all the documentation 
ourselves. I'm doing the 

documentation myself. Right now, 
that's the way it's been. Hopefully, in 
the end, it won't be that way. The only 
completely written piece of 
documentation right now is the user's 
manual. 

Plus, we've put together about a seven- 
eight page marketing blurb that I didn't 
write, I edited, for one of the Germans, 
this guy Dieter Preiss, who's the head 
of the project in Braunschweig. He's 



very good, extremely good. He's too 
modest about his English, he's 
actually very good with English, but I 
took it and edited it for him. 

So I've written the user's manual. It 
goes into great detail about it. It 
doesn't pretend to be a tutofial about 
the PC itself, it's just how to use these 
display windows. 

Right now, the only thing that exists for 
programmers, if we were going lo give 
it to programmers today, would be the 
include !iles, which are reasonably 
well documented. It's not a good 
programmers guide. On the other 
hand, we're not willing to release it to 
programmers yet. What we're showing 
here at COMDEX, we're only calling the 
COMDEX release. They're probably 
going to take this version of it, and 
make a bunch of them and give them to 
dealers. 

JF: Do you know when evaluation 
units will go to developers? 

RJ: I don't know. This one couldn't go. 
What we have now couldn't go to 
developers because we pulled out all 
of the stuff that was close, all of the 
stuff that kind of worked, but every 
once in a while wouldn't work well, we 
yanked allot that. 

The most important thing about the 
Sidecar, about the PC, is for it lo never 
crash. If we're going to say this is PC 
compatible. It's got to never crash. 
It's got to always work, and always 
stay up. Otherwise, it's going to fail, 
and you're going to be talking with the 
Guru while you're using your PC, it's 
not going to make you real happy. It's 
not going to make you feel like you've 
made the right purchase. It was 
essential for us to not show anything 
here that had any risk of not working 
correctly. We have a lot more done 
than we're actually showing here. 
We're just a few weeks away from 
having the rest of it done. 

JF: Things like the file interface? Can 
both of them access the 5 1/4 drive at 
the same time? 

RJ: Both of them can access the hard 
disk at the same time on the PC side. 
We set it up so that you don't have to 
buy a parallel card for your PC, 
because you can use the Amiga 



parallel port. 

that way. 



In the end, it will work 



Hopefully, we'll be able to pull off the 
same tricks for the serial port. You 
don't need a color or monochrome 
display card, because these come 
built in automatically. They 
completely use one another's facilities 
together. You can write this code that 
asks the PC to use it's 8087 
coprocessor. 

The way I envision it, is to have a task 
that's running, and the PC would send 
requests to this task, and this task 
would then turn these requests into 
calls to graphics routines, executive 
routines, so that the PC can get at the 
Rom Kernal. 

JF: It opens up a lot of potential for 
debuggers. 

RJ: Oh, yeah. The thing that is most 
exciting about it is not that it's a PC 
and an Amiga stuck together, but that 
it's a new machine, that has both 
processors. It's yet another 

coprocessor in the Amiga 
environment. It's a brand new kind of 
machine, a new generation of machine, 
a hybrid, where the two of them exist 
at the same lime. This is the most 
exciting thing. This is the thing that 
may. if enough people get behind it and 
support it, could lead to a new 
generation of thinking about the Amiga 
computer and the PC as both in one 
box. [HINT. I don't think he was 
supposed to say that yet.] But I don't 
ever want to lose the Amiga computer. 
I think the Amiga computer is superior 
in every respect, I don't want people 
!o ever lose sight of that. In fact, I 
was surprised by the PC. I had never 
looked into it (hat deeply before this 
project. It's just a better Apple ][. I 
was expecting some incredible, 
glorious system. I didn't know what i 
was expecting to find in there. 

JF: Did you read Dr. Dobbs this 
month? 

RJ: No. 

JF: It explained how the RAM disk 
handler works in the AT. The ram disk 
handler gets a request through the 
operating system. It sets a flag, 
reprograms the keyboard controller to 
reset the processor in a short amount 
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of time, then waits, reboots, goes 
through the boot ROM, and checks the 
flags to see it was doing a ram disk 
call, and then gives the data to the 
calling program. 

RJ: That's extraordinary, almost 
unbelievable. I had this unfounded 
reverence for the IBM, not because I 
understood it. The typical, 

stereotyped, same set of beliefs that 
everyone else had. If it said IBM on 
the outside, you fell for it. 

JF: Like all these IBM clones walking 
around. 

RJ: It's not a bad machine. I'm not 
degrading the machine at all. AH I'm 
saying is that it is no glorious machine. 

My greatest dread was thai I was 
brought out to do this project, and I 
didn't know the PC. I figured I'd spend 
the first two months of this two-and-a- 
half month project just learning the 
PC, before I would be able to do 
anything with it. 

I was delighted to find that I had 
learned most of everything that I 
needed to know on the plane ride to 
Germany, by going through a couple of 
the books that I had. Fortunately, 
some books that are out there that are 
very succinct, very clear-cut, 

description of what's going on inside 
the PC. Where those books were 
vague, I grabbed the PC Technical 
Reference manual, and where I found 
that too was vague, then I had BASIC, 
and I could write little programs, and 
say "What happens when you hit this 
hardware register with this value, then 
what really happens?'" 

That's been a real interesting process. 
The monochrome is no big deal to 
mimic, but the color display, by writing 
to hardware registers, you can change 
it to all these high-resolution modes. It 
was a real trick to follow all of that, and 
the logic is, unfortunately, not clean. 
There's convoluted bits, and it takes a 
convoluted understanding of what 
things are supposed to happen, and I 
didn't have it quite right. 

Are you familiar with the Microsoft 
Flight Simulator lor the PC? Well, 
Artwick's a friend of mine. [Ed: Bruce 
Artwick, the author of Flight 



Simulator.] I was constantly resisting 
calling him. I wanted to call him, and 
say "What did you do?" 

His program would misbehave so often 
with my code. To get his magic to 
occur on the PC, he uses every trick 
in the book, he uses every 
idiosyncrasy known about the PC to 
get it to work that wefl, and to get all 
that real beauty. 

And so the Flight Simulator, Irom the 
very beginning, was one of my test 
cases. If I could get the Flight 
Simulator to work, through my 
software, if I could have his flight 
simulator, in an Amiga window, which 
was always one of my dreams, then I 
knew I was doing OK, that 1 was on the 
right course. 

So, a lot of the time when I was doing 
my development, 1 would have the 
Flight Simulator up in an Amiga window. 
You can't just have it there, because 
that doesn't say if it's really working, 
you actually fly it around a little bit, 
and have the display change. So I was 
constantly flying it around a little bit. 
This proves to be rather hazardous !o 
one's productivity. I'd sit there for 
twenty minutes trying to land this 
thing. 

There was one day when I really got 
interested in it, and I looked at the 
invoice I submitted to Commodore on 
that date, and it looked like Swiss 
cheese - all these holes in it. Fifteen 
minutes here... With any luck, this will 
prove to be the first step in a new wave 
of computers. It's hard to say what 
will really come of it in the long run, 
because nevertheless, it's a kludge. 
It's taking two established computers 
and sticking them together. 



A multiprocessor environment is really 
where it's at, and that's where it will go 
in the future. I think that DMA is a 
crude example of multiprocessing, but 
the wave of the future is to never sell a 
box with one processor in it ever 
again. This is an interesting 
application of this idea, having two 
processors in one, and I think that a lot 
of people will get behind it. I hope that 
a lot of programmers will, I hope that 
this goes further than just the Sidecar 
attached to the Amiga. That 

someone, Commodore or someone 
else takes the idea one step further, 
and makes it more of a coherent 
melding of different processors. 

The Amiga and the PC happen to be 
well-suited for this, because of the 
enormous software base available for 
the PC, and the enormous graphics, 
sound and multitasking capabilities of 
the Amiga. The two of them fit together 
really nicely. 

JF: What was your impression of the 
German engineers you worked with? 

RJ: They were all very good. I had a 
good time working with them. I wished 
they had spoken with me earlier. I 
would have strongly encouraged them 
to wrap the Sidecar around the top of 
the Amiga, rather than going right in on 
the side. 

They considered it. They said they 
could have found a way to do it, but it 
would have been very hard, because 
of the length of the cables involved, 
and the transmission times. They 
weren't as sensitive as we are to the 
footprint of the machine. It's a 
different philosophy in Europe. 
They're more concerned about the 
power of the machine. 
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Roomers 

byThe Amigo 



Because so much happened in the past few weeks, I 
squeezed the layoffs and Comdex in, but not much 
else will fit. 11! get to the hard rumors next month... 

Sorry to Start on such a bad note, but news is news, 
and the most important goes first: Much of 
Commodore- Amiga is gone! First, back in December at 
the height of friction between Commodore and Amiga, 
Carl Sassenrath (author of Exec, the Amiga's Kernel) 
and RJ fvlical (author of Intuition, the user interface) left 
Amiga on their own. Bob Pariseau (VP of Software) 
came ciose to leaving also, along with others. It is not 
clear that these actions came because of the friction, 
but the timing was the same. 

Now, after Comdex, Commodore decides to cut much 
of the staff. "Only management and engineering 
support were cut," the press release says. Now gone 
are Bob Pariseau (who got his in the first wave), Sam 
Dicker (the Amiga sound guru), Rob Peck (Quality 
Assurance), Bruce Barrett, Kodiak Burns, the Amiga in- 
house artists, Stan Shepard, Barry Walsh and about a 
half-dozen others. Amiga support on the East Coast 
was not cut. 

Without editorializing, let it be said that the CBM folks 
on the East Coast turned to Amiga on the West Coast 
for the answers, not the other way around. Needless 
to say, the people who brought you the Amiga are 
stunned. Those that are stiil left don't know how long 
they'll be around. A good week of development and 
bug fixes of version 1.2 was lost because of people 
bumping into desks and the like. People are 
recovering, but it's not something that is easily 
forgotten. Dale Luck, graphics wizard at Amiga, left for 
"an extended leave of absence" (his words) from May 
23 to September 1, Let's hope he comes back 
September 1. 



COMDEX 

OK. Let's talk about Comdex. It was wild. In this 

Amigo's opinion, the Amiga booth (Commodore had 
no C-64's or C-128's there) was the most crowded 
booth in the show. Next to the Amiga booth was the 
Lotus booth, which was bigger than the Amiga booth - 
- and empty. ^ 



Commodore president Tom Rattigan was heard 
wondering aloud if maybe Lotus (who picked up two 
developer machines at the show) would be willing to 
rent some of their floor space to CBM... There were 
ten 'stations', each with five Amigas. Each station was 
dedicated to a certain type of software - there was 
music, business, entertainment, education, financial, 
productivity, technical, graphics and hardware 
applications demonstrated, with overlap in some 
booths. 



HARDWARE 

MicroForge showed their line. A spokesman was 
quoted as saying that MicroForge intends to support 
the Zorro specification, contrary to what they had 
originally stated. 1 heard that MicroForge just raised 
their prices; also that MicroForge just LOWERED their 
prices! Huh? 

Byte-by-Byte showed the PAL, an expansion box that 
sits on top of the Amiga (under your monitor) and 
contains a power supply, 512K of RAM, a 20MB disk 
drive (expandable to any two half-height drives ... they 
had a 50MB drive at the show) a clock/calendar and 
four expansion (Zorro) slots. Prices should be around 
$2500, available this month. 

Byte-by-Byte also said they have a 2MB RAM board 
that can be upgraded to 8MB when IK DRAM chips 
become available in quantity, and they have also been 
contracted by A-squared to do a board that does LIVE! 
HAM images. Their show flyer stated that 
development was underway for a frame grabber, 
graphics tablet, digitizing tablet, professional music 
hardware and software, and an Ethernet board. 

Speaking of LIVE! and HAM, A-squared never made 
their appearance at the show but the LIVE! board was 
there, and the software was doing HAM. It was rather 
primitive, but it was HAM. Each image took about 8 
seconds to draw, and the software had no provisions 
for manipulating the image. 
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The Digi-View system was also at the show -- in fact it 
was back to back with LIVE! - which only does HAM, 
and does it well. You have to take three nnonochrome 
pictures, (with the digitizer), each with a different filter 
(red, green and blue); the software combines them 
and produces an image. The software also allows you 
to play with the color palette, so you can fine-tune the 
image if you like. My impression was thai the Digi-View 
system produced belter quality pictures, and Digi-View 
is cheaper. 

However, LIVE! can do real-time digitizing, and has the 
potential for accomplishing all that Digi-View does, if 
somebody would come out with the software to do it. 
Another factor is availability. You can get Digi-View 
NOW, and nobody seems to know when LIVE! will 
become available. At the show I heard that the LIVE! 
board was put together by hand, and was designed in 
such a way that mass producing boards was 
impossible, so it's being redesigned. 

Also on display was the Genlock video mixer. This 
Amiga had no salespeople around it, because the 
Genlock just sold itself. They just set the device for an 
equal mix of Amiga and external video. People walking 
by could see themselves on the monitor while other 
standard Amiga demos ran, such as Amiga-3D and 
Fields. 



CSA was not at the show, but Dale Luck of C-A 
brought an expansion box with him and had it there for 
all to see. It is a Zorro backplane with power supply, 
stands about 9x9 by maybe a foot high (I think it looks 
like a square smokestack) and the CSA "Turbo Amiga" 
boards have been modified to meet the Zorro board 
size (of course they don't meet the startup auto 
configuration code, since they take control of the bus!) 



Also at the show in spirit were Comspec and CardCo, 
who had their 2MB and 1MB memory boards, 
respectively, at the show via other developers. 

Applied Visions had their "FutureSound" sound 
sampling device, and Mimelics was demonstrating their 
"SoundScape" sound sampling device and associated 
software. Quoted SoundScape prices at the show 
were $99, but Mimetics has recently raised the price to 
$150, which most audio people I've talked to agree is a 
more realistic price for all the things that SoundScape 
can do. 

Sharing a booth with Activision was Golden Hawk 
Technology, showing their "MIDI Gold" interface box. 



Tecmar wasn't demonstrating at the booth, but they 
did have an Amiga at their own booth, and had the T- 
connect and T-disk there. The good news is that the T- 
disk no longer sounds like a vacuum cleaner! The 
sales rep there was very pleased when we put our ear 
on the drive and didn't hear anything. "Yes, we fixed 
it!" he proudly announced. The bad news is that the 
price cuts they were considering have not come to 
pass, and the controller is still outside the drive. 

U.S.E. Inc had flyers for their "BoingBag" Amiga 
carrying cases - The Model 1200 at $130, which 
carries the Amiga and has enough room left for two 
3.5" disk drives, and the Model 1080 at $90 to carry 
your Model 1080 monitor. 

The AmigaModem exists! At least one does, anyway. 
The modem made a brief appearance at the show. A 
sticker on the bottom said "Prototype #1 - 4/25/86". A 
spokesman for CBM said the modem and software 
have been done for a while; the holdup has been 
getting power supplies and DB-25 connectors! 

Commodore had two Electrohome long-persistence 
monitors at the show, just to show that the Amiga likes 
them. Jay Miner, designer of the Amiga's graphics 
chips, said that he foresaw a decrease in prices for long- 
persistence monitors, and that the main reason they 
have been so high is that the market for them has been 
rathersmall. 
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A visit to the Electrohome booth revealed that the 
monitors Commodore was displaying have been 
discontinued by Electrohome, and a new, better 
looking and less expensive model has taken its place. 
Available now for $1 095 or so. 

Sony had two Amigas at their booth, one showing 
RoboCily on a projection monitor and another showing 
Digi-View HAM slides on a KV131 1CR monitorATV. 

A quick stop at the Iomega booth revealed that they 
hadn't seen a market for the Bernoulli Box on the 
Amiga, but after seeing the Commodore booth, two of 
Iomega's Engineers admitted that it was certainly worth 
looking into. 

And of course there was the hit of the show -- the 
Sidecar. I saw A-C "sub-editor" (hey, that's what his 
name tag said} John Fcust running around tugging on 
people to get the inside scoop on the Sidecar, so I'll 
leave that for him to tell. I did hear that there was some 
friction between a CBM exec and the engineers about 
the number of expansion slots; he wanted one, they 
wanted three. Last I heard, it would have three. Here's 
one for the engineers! 



SOFTWARE 

There was a lot of software at the booth, too. We had 
Lattice and Manx next to each other, each showing 
their C compilers and other utilities. 

Metadigm was showing its debugger for the Amiga, 
MetaScope, at another station. 

The folks from MaxiSoft were showing their new and 
better MaxiPlan (an integrated Spreadsheet/ Data- 
base/ Chart Maker), along with the rest of the 
MaxiSeries - MaxiComm (terminal program), MaxiDesk 
(desktop management), MaxiMizer (macro maker), 
MaxiShare (real-time data sharing for two Amigas), 
MaxiKey (looks like MaxiMizer to me) and MaxiCache 
(dynamic disk buffering). 

Mindscape had a few games: The Halley Project, 
Racter, Deja Vu (graphic/text adventure), Keyboard 
Cadet and Brataccas. 

First Byte (not to be confused with Byte-by-Byte) 
whose advertising claims are the "world's leader in 
software speech technology," had two packages; 
KidTalk and SpellerBee. 

Digital Creations was showing the Gizmoz productivity 
set, a package of fifteen desk accessories for $49. I 
hear the LIFE game is pretty good. Digital Creations 
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also had Digital Link, which lets your Amiga talk to Macs 
and IBM PCs. In fact, for $69 you get three disks -one 
for each machine! 

SoftWood Company showed MlAmiga File, a database 
management system for the Amiga. I've never used a 
database manager, and was impressed at the ease of 
use of MiAmiga File. Moving a column is as easy as 
clicking in the column and dragging to another place! It 
supports selection by example and range, multi-field 
sorting, and more. 1 can see that it can't do 
EVERYTHING that you'd like a database to do, but for 
$99 it looks pretty good. Not to spoil the parly, but I 
hear of problems running under V1.2 of the system 
software. Will keep you posted. 

Also in databases a fully relational database from 

Transtime,for$350-$500, 1 think. 

A competitor is Taurus Software, who has Acquisition, 
also relational and in the same price range. 

Software Circuits, Inc was giving a demo of their PC 
Board Layout system ... called PCLO, it retails for 
$1024 and is the first in a line of design tools for the 
Amiga. It uses 320-by-200 line resolution (for memory 
efficiency and CPU speed, they say), and claim that 
CardCo laid out the 1MB RAM card using their 
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THE EXPLORER 

A tool to match your curiosity! 

Would you like...to scout the inner workings 
of your Amiga? ,..a live window onto nnemory 
to watch what other tasks are doing? ...an 
on-line memory map to tell you where you are? 
...to actually see the assembly language code, 
in human readable form, that exists inside your 
Amiga? ...to step through a piece of code to 
see what it does? ...to capture your own 
source code and customize it? 

The EXPLORER has some powerful fea- 
tures that make it a superb extension of your 
curiosity. Features: display memory and files 
in Hex and ASCII, memory modify, search, 
move, fill, display and change registers, 
disassembly trace, load programs, disassem- 
ble to disk. Output to printer or disk file. 
Powerful commands: loops, text display, real- 
time RAM view, & more! The EXPLORER puts 
your sense of wonder in charge! 

The EXPLORER can be used for serious 
program development too! As a debug tool the 
EXPLORER'S command set is compact and 
efficient. You can execute your commands 
within loops, creating live displays of RAM or 
registers while you test your program. You 
control the display format too, and even display 
informative messages. No need to waste 
valuable time typing that patch into memory 
every time you debug. Simply write a new 
command to do it for you. After all, what are 
computers for? When you want to save the 
contents of RAM or a series of trace steps 
for future examination, just send them to the 
printer, or better yet, send them to a disk file! 
PRICE: $49.95 plus $3 shipping and handling. 

COD add $4. Visa/MC orders call (612) 
871-6283. Money orders or checks to: 

Interactive Analytic Node 

2345 West Medicine Lake Drive 

Minneapolis, Minnesota 55441 



package. PCLO supports libraries of items, high- 
speed routing, and source for the plotter driver, so you 
can customize your own. 

New Horizons had Flow, an idea processor for$99. 

Classic Image had a flyer showing a game called Diablo 
for $30 and Disk Library, a disk organizer, (or $50. 

Byte-by-Byte showed Write Hand, a word processor for 
$50, and InfoMinder, a hierarchical "information 
database." infoMinderSupports IFF, cross-referencing, 
context sensitive help, different display colors and 
styles, and more. It was running on their PAL 
expansion box (with 50UE DMA hard disk), and it was 
FAST! They had the entire ROM Kernel Manual on 
line, and could get to any section of it in seconds. 

Also by Byte-by-Byte is Financial Plus, a small- 
business program that does Accounts Payable, 
Accounts Receivable, General Ledger and Payroll. 

VIP Technologies showed Professional, a $200 
integrated spreadsheet that is identical to Lotus' 1-2-3 
in everyway I saw. 

Micro-Systems Software was showing Scribble!, their 
$100 word processor; Analyze!, the $100 
spreadsheet; Online!, the $70 terminal program; and 
BBS-PC!, the $1 00 bulletin board system. 

Commodore had a software product at Comdex. It was 
the Mind Walker game (formerly WyndWalker but 
changed for some legal reasons). 1 wasn't too 
impressed but everyone else that I talked to said they 
thought it was great. 

Aclivlsion showed their graphics/text adventure 
games, like Borrowed Time, Hacker and MindShadow, 
as well as their $59 Music Studio software, which was 
making quite a lot of noise. 

Across from Activision were Mimetics and Electronic 
Arts. Mimetics was showing their SoundScape Digital 
Sampler, which will sample anything - they had a CD 
player and a microphone at different times - and play it 
back, either from your Amiga keyboard or a MIDI 
keyboard. The software is what makes the package 
great, however. You can adjust attack/decay 
parameters, set up multiple triggers, looping, etc. Truly 
impressive for $150. 

Electronic Arts had its software out, including some 
first peeks at some of those games we've been waiting 
for. 1 must report that Marble Madness looks truly great. 
Also demoed were One-on-One, Skyfox, Instant 
Music, Deluxe Video Construction Set, Deluxe Print, 
Deluxe Paint and more. I was surprised to see a demo 
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of Instant Music; i'd heard (and previously reported) that 
it was cancelled -- bu! no) It looked easy to use, but not 
something for any serious music. On the other hand, 
the package that all musicians have been waiting for - 
- Deluxe fvlusic Construction Set -- was not shown at the 
show. 

Aegis Development was also there, showing its 
products: Animator, Draw and Images. Images now has 
more features. 

Both Aegis and EA were at each other's throats during 
the show -- Aegis had a press release politely damning 
EA for their copy protection; EA had a checklist of items 
that Deluxe Video does that Aegis Animator can't. 

Jt^/IH Software of Minnesota, Inc was showing their 
talking coloring book, a program you (or your kids, 
right?) can use to draw pictures and color them, simply 
and quickly. 

TDI was showing its Modula-2 compiler at the same 
Amiga as MicroForge. The demos they were running 
were pretty fast, and TDI has been pretty active getting 
people to give up Pascal for Modula-2. TDI has also 
been active on the networks and bulletin boards 
supporting the product. 

At the show by flyer only were DeBern Data 
Management ($125 Checkbook Manager), Zoxso ($49 
ZLI command line interpreter) and Pecan Software 
Systems, Inc ($79 UCSD Pascal). 

And all this was in the Commodore booth! I spent a few 
DAYS hopping around the floor, looking for Amigas in 
other booths and bugging software developers to port 
their stuff to the Amiga. Many developers were 
impressed for the first time, and indicated they'd now 
start seriously looking into the Amiga. 

SSI, makers of WordPerfect for MS-DOS, announced 
they were changing their name to WordPerfect 
Corporation, and a sales rep at their booth said they'd 
have an Amiga version "in about six months." 

RUMORS 

There were a lot of rumors at the show. The largest 
centered around the upstairs at the Amiga booth. Only 
dealers were allowed to go up there, where - among 
other things - the Amiga 2 was on display. Actually, 
everyone at the show was calling it the A2000. Of 
course, the Amigo got the scoop on it and the other 
prototype hardware. 

Next month I'll return with all the regular rumors that I 
didn't have space for this month, including a full report 
on the new hardware coming from Amiga. 

•AC- 
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IMEW! 
EXPERT SYSTEM KIT 

Those of us who get excited about computers 
have been looking for the application that 
takes us into the twenty-first century. This 
is it! Now you can create an expert system 
that will grow with your Amiga. Would you 
like a computer system straight out of 
science fiction sitting in your own home or 
office? How powerful can it be? As big as 
your imagination, because you build it the way 
you want it! 

We supply the EXPERT SYSTEM driver along 
with a sample knowledge base. Complete 
instructions guide you to creating your own 
application. Experiment with artificial intelli- 
gence! The software driver analyzes your 
data and learns to draw the correct con- 
clusions. Think of the applications! Diagnose 
circuits, plant and animal diseases. Predict 
events based on past performance — 
weather, stock market, sports. Build the 
ultimate science project or develop a com- 
mercial application! We will be supporting this 
kit with a newsletter so you can share 
knowledge bases, techniques and ideas. 

PRICE: $69.95 plus $3 shipping and 
handling. 

COD add $4. Visa/MC orders cail tei2) 
871-6283. Money orders or checks to: 

Interactive Analytic Node 

2345 West Medicine Lake Drive 

Minneapolis, Minnesota 55441 
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AT COMDEX 



AMIGA Developers ^ 
Appearing at COMDEXj 



Actlvision, Inc. 

2350 Bayshore Frontage Road 

Mountain View, CA 94043 

(415)960-0410 

Aegis Development, Inc. 
2210 wilshire Blvd., Suite #277 
Santa Monica, CA 90403 
(213)306-0735 

Applied Visions 
ISOak Ridge Road 
Mediord, MA 02155 
(617)488-3602 

Byte-by-Byte 

3736 Bee Caves Road., Suite #3 

Austin, TX 78746 

(512)328-2983 

Cardco, Inc. 
300S.Topeka 
Wichata, KS 67202 
(316)267 3807 

Commodore Business Machines 
1200 Vi/ilson Drive 
Westchester, PA 19380 
(215)431 9100 

Computer Food 
2215 Sarah Court Suite 80H 
Norcross.GA 30093 
(404)851 9103 

Comspec Communications, Inc. 
1 53 Bridgeland Ave., Unit 5 
Toronto, Ontario Canada M6A 2Y6 
(416)787-0617 

Copperstate Business Systems 
(Distributors for Softwood Company) 
3125 E. McDowell Rd. 
Phoenix, AZ 85008 

Digital Creations 

530 Bercut Drive. Suite F 

Sacramento, CA 95814 

(916)446-4825 

Electronic Arts 
1820 Gateway drive 
San Mateo, CA 94404 
(415)571-7171 



First Byte 

2845 Temple Ave. 

Long Beach, CA 90806 

(213)595-7006 

Golden Hawk Technology 
427-3 Amherst Street, Suite 389 
Nashua. NH 03063 
(603)882-7198 

JMH Software of Minnesota, Inc. 
7200 Hemlock Lane 
Maple Grove, MN 55369 
(612)4245464 

Lattice, Inc. 
P.O. Box 3072 
Glen Ellyn,IL 60138 
(312)858-7950 

Manx Software Systems, Inc. 
1 Industrial Way, W.,Bldg.B 
Eatontown, NJ 07724 
(201)542-1871 

Maxisoft 

2817SloatRoad 
Pebble Beach, CA 93953 
(408)625-4140 

Metadigm, Inc. 

1 9762 MacArthur Blvd. Suite 300 

Irvine, CA 92715 

(714)955-2555 

The Micro Forge 
398 Grant Street SB 
Atlanta, GA 30312 
(404) 688-9464 

Micro Trends Inc. 
650 Woodfield Drive Suite 730 
Schaumburg, IL60195 
(312)310 8928 

Micro-System Software, Inc. 
4301 -18 Oak Circle 
Boca Raton. FL 33431 
(305) 832-2503 

Mimetics Corporation 
P.O. Box 60238 Sta. A 
Palo Alto, CA 94306 
(408)741-0117 



Mindscape 

3444 Dundee Road 

Northbrook, IL 60062 

(312)480-7667 

New Horizons Software 
7806 Evaline Lane 
Austin, TX 78745 
(512)280-0319 

Soft Circuits, Inc. 
401 S. W. 75th Terrace 
N.Lauderdale, FL 33068 
(305)7212707 

Softwood Company 
P.O. Box 2280 
Santa Barbara, CA 931 20 
(805)966 5884 

Taurus House 

3 Bridge St. 

Guildford, Surrey England GUI 4RY 

(0483)502048 

TDI Software, Inc. 
1 041 Markison Road 
Dallas, Texas 75238 
(214)340-4942 

Teem a r 

6225 Cochran Road 

Solon, OH 44139 

(216)349-1009 

Transtime Technologies 
797 Sheridan Drive 
Tonawanda, NY 14150 
(716)874 2010 

U.S.E., Inc. 

8E. 300 South. Suite #715 
Salt Lake City. UT 841 11 
(800) 942-9402 

VIP Technologies Corporation 
132 Aero Camino 
Santa Barbara, CA 931 17 
(805) 968-4045 

Zoxso 

P.O. Box 283 

Lowell, MA 01 853-0283 

(617)655-9548 
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How does Sidecar affect Transformer? 

Conducted by John Foust 



This is an interview with D. Douglas Wyman, the director of marketing 
and operations at Simile Research, the producers of the software 
tBf^ emulatar. Wyman discusses the beginnings of Simile Research, 
the fate of the hardware accelerator, and the expected influence of 
the Sidecaron the IBM emulator market. 

JF; I'd like to find out how Simile Research got into the software 
emulation business. I understand you originally did mainframe 
emulation. 

DW: fifly partner, William Teal, when he was an undergraduate at the 
University of North Carolina, had emulated one ol the IBM 
mainframes on the school's Burroughs mainframe. They didn't have 
an IBM, so they wanted the ability to run a lot of the IBM software. 
So he did that eis his senior thesis project at the University of North 
Carolina. 

JF: I had heard you were a two-man operation. 

DW: That's right. 

JF: AndthatComm odore had heard about you r emulation . 

DW: Well, we approached them. We had originally written the 
program on a Tandy Model 16, which uses the 68000, Tandy was 
interested in it, What had happened was Bill had approached me with 
the idea, and asked if I thought it was mari<etable. 

Having used to work lor Tandy, I knew a lot of corporate customers 
thai would have like the ability to run PC software on the Model 16s 
they had already bought. So I knew that there was a market for it- 
He said that he could write the program, and he knew I would put 
together the marketing for it, so we got together, and formed a 
partnership, and I financed the start of the company, and negotiated 
the contract, and he wrote the program. It's really kind of incredible, 
because it's all written in assembly language, and it's about 64 K , 
and it's been re-written about three times, This has all been done in 
the last two years. Bill has really done a super-human feat of 
programming. 

JF: Could you describe a flowchart of how the program works? Or is 
that proprietary? 

DW: A lo! of it is proprietary. On a broad scale, it is an interpreter. 
But we have some proprietary software techniques that cut down 
tfie amount of overhead that you get traditionally in an interpreter. 
We were working with Commodore on developing some hardware 
enhancements for our program. We had been shown that 
theoretically it would be possible to substantially speed up the 
emulator by putting a lot of it in siiicon and taking the load off tfie 
processor. 

JF: What happened with that? 

DW: Well, they abandoned Ihe project. They still might pursue it at 



some future date, or they might get a third party to pursue it. They 

haven't really indicated to us which direction they are going to go. I 
guess that's their prerogative. We're willing to work with them or 
another company that wants to pursue that, though. There are 
obviously some benefits for the consumer in that approach. 

JF: Can you tell me about some o( the problems you've had with the 
emulaten, such as copy protection? 

DW: Obviously, if everyone wrote their programs to the PC 
specification, it would have been a lot easier to write the emulator. 
To do the emulation successfully, since so many of the programs go 
below the operating system, directly down to the chip level, for our 
emulation to have been successful, we had to that go to that extent 
also. So we emulate not only the machine specilications, but we 
emulate it right down to the chip level. That's the only reason you 
don't have the color graphics at this point in time. It's not a matter of 
not being able to do it, it's just that we haven't implemented that pari 
of the system yet, we've only Implemented the monochrome 
graphics. There's really no reason we couldn't even go to EGA 
graphics, or whatever. 

JF: Have you looked at the Sidecar? ■ ; ' 

DW: Yes, I've looked at the Sidecar. I know a number of companies 
have tried to get 8088s to work with 68000s in the past. There was a 
computer on the cover of several magazines about two years ago 
called the Rainbow. They had a lot of problems with that 
Amiga, when they were Amiga, even, looked into that, and 
abandoned it. The 8088 architecturally does not lend itself well to go 
in with a 68000. If they can pull it off, more power to them, because 
it's really a difficult engineering feat. 

The question I would have about that particular approach is that I 
doubt really if you could get significant economies over just going 
out and buying a Korean or Taiwanese clone, and how much extra 
value does Ihe user get from that over our program, let's say. 
Our program, granted, does not run as fast as a PC, which is the 
lowest common denominator as far as what is expected. People are 
looking at AT performance. However, we do allow people to run their 
programs. Most programs are I/O bound, and not processor bound. 
In actual use, a lot of programs people use are databases and word 
processors, there is not really that much visible degradation to the 
user. 

At the price point we can sell our package, with a 5 1/4 inch drive, it 
really makes a lot of sense lo the consumer to take full advantage ol 
the advanced technology of the Amiga, and possibly bring home 
work from the office, where they might be using the PC. 

I can understand why they might have gone to a Sidecar, jusi to 
cover all the bases. It gives them a complementary situation. They 
can go in the low-end, low-cost, PC-compatible solution, and they 
can have a deluxe solution for the people where the speed is really 
an issue. The consumer really benefits from it. I think everyone 
really comes out ahead of the game. 

•AC- 
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AMIGA DISK UTILITY 

The First Disk Repair Kit Available 

: Restore deleted files 
: Repair errors 

: Recover data from damaged files 
: Edit in HEX or ASCII 
: Simple control using mouse 
: Complete Documentation describing 
the disk and all the sector types 

Diskwik gives you total access and control of your disks far beyond that which DOS 
allows. DISKWIK has features for the novice and advanced user, including such life 
saving features as restoring deleted files, and eliminating any errors on the disk 
except those due to defective disks, The INFO option will give you block type, 
filename, bytes in file, protection status, and more... 

The documentation included is worth the price alone. In it you will learn how data 
is stored, how the directory works, and all the different types of sectors are 
explained. Diagrams matching the screen on your monitor make it easy to locate and 
identify the different sections. All this and more gives you the knowledge to fix 
corrupted disks, or just experiment. 

Advanced features include editing in HEX or ASCII, copy blocks to the same or 
anoUier disk. Re-format tracks, correct checksums, open a file to a ram disk to save 
one or more individual blocks for later use. 

DISKWIK fully utilizes the mouse to make moving around the disk as easy as tlie 
push of a button. All this for only $49,95 makes it a true value. DISKWIK is 
available from: 




P.O. Box 665 

Glendora,CA 91740 

(818) 334-0709 

Dealer Inquires invited 
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Microsoft Basic 
Tutorial Part III: ^ 
M BASIC Features 

by Kelly Kauffman 
013 70206,640 



Welcome back to the MBasic tutorial. In this third 
installment, I will tell you about a couple of main features in 
fvlBasic and we'll start to get a little better working knowledge 
of the language. 

Probably one of the most important backbones of any Basic 
language are variables. Variables are symbols to the 
computer that can change values. Think of them as labeled 
boxes with different numbers in them. Variables take the 
form of letter{s). For instance you can name a variable 
"AMIGA" if you like. 

The only restrictions on variable's name are (1) They cannot 
be a name that is ALSO a command in MBasic. Those 
names are listed in your Amiga BASIC manual on page A-13 
and A-14, (2) They are limited in length to 40 characters, and 
(3) They cannot contain any spaces. Some examples of 
acceptable variable names are: 

RUNNCLOSE_WINDOWOPEN_DlSK 
THE_AMIGAJS_GREAT 

AMAZING COMPUTINGBUTTON 



Tal<e for example the first variable -"RUNN." We can assign 
it a value by giving MBasic a command like: (Note that this 
command can be typed into the LIST window and then RUN, 
or you can type it in the direct command window.) 

LETRUNN=322 

Then, in the direct mode we can say: 

PRINT RUNN 

The computer will respond with: 

322 

This is what the name variable means. Now you can issue 
the command: 

LETRUNN=RUNN+RUNN 

The computer will take the current value of RUNN and add it 
to the current value of RUNN and then re-asstgn it to the 
variable RUNN. So in essence we have: 

LETRUNN=322+322 



Now, when we ask the computer to display the contents of 
RUNN, it will come back with 644. 

it should be noted that the "LET" command is optional. It is a 
good idea for beginners to use it, but when you become more 
proficient in MBasic, you will begin to omit it which will free up 
some extra programming memory. 

It is also good practice when naming your variables that you 
give them names that will represent something to you. 
Naming variables "I" or "W" ARE acceptable, but when writing 
long programs with lots of variables, you will find out that you 
won't always remember what "I" or "W" represent. For this 
reason, it's good to name your variables with a word or words 
that will make sense to you. For instance, if you're writing an 
inventory program, instead of naming the variable "X" for the 
retail price, call it "RETAIL." This will save countless time in 
looking up the meanings of your cryptic X's and W'sN! 

Another useful feature of MBasic are called FOR/NEXT 
LOOPS. There are two parts to this command, the FOR and 
the NEXT. There is also an OPTIONAL third part, the STEP 
command. 

The syntax for this command is: 

FOR <var>=<arg1 > TO <arg2> 
NEXT<var> 

The word FOR defines the beginning of your loop, while NEXT 
defines the end of it. The variable name {<var>) is any name 
you assign, and <arg1> and <arg2> are the range of the loop. 
Here's an example of a FOR/NEXT loop. 

FORLOOP=1TO100 
NEXT LOOP 

In this particular loop, the variable LOOP will be changed 
from 1 !o 2 to 3 to 4... etc. until it reaches 1 00. 

You can also place statements within the FOR/NEXT loop. 
Say you wanted to print the actual contents of LOOP as it 
was actually doing the loop. Then your program would look 
like this: 

FORLOOP=1TO100 
PRINT LOOP 
NEXT LOOP 
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Expand your Amiga's music capability lo a new creative edge... 
Introducing 

MIDI GOLD 

MIDI Interface Hardware for the 
Commodore Amiga Personal Computer 

• Dual MIDI Out and single MIDI In connections. 

• Sync Out connection provides clock and start/stop 
control for drum machines and other devices. 

• Connects directly to the serial port. 

• Custom metal enclosure. 

• Complete with interface cable. 

• Full technical information will be made available to 
all Amiga product developers. 

PRICE S79.95 - Call or write for availability. 
GOLDEN HAWK TECHNOLOGY 

427-3 Amherst Street, Suite 389 
Nashua, New Hampshire 03063 

(603) 882-7198 \^cckdays 21'M-10PM EST 

DEALER INQUIRIES WELCOME 
Amiga is a (radcmark of Commodore-Amiga, Inc. 



When you ran the program you would get 1...2...3...4 up 

until 100. This can let your produce some very interesting 
effects. 

To change what the computer counts b'y, you can include the 
forementioned STEP 
command. Example: 

FOR LOOP=32 TO 81 32 STEP 2 
NEXT LOOP 

In this loop, the computer will start off with LOOP being 32. 
Then it will increment from 32 to 81 32 by 2's. In other words, 
the computer will jump back and forth between the FOR and 
NEXT command 4050 times. Each time it does, it increments 
LOOP by 2. Notice too, that you dcn't have to start your 
loop at 1. It can be any number and doesn't have to be a 
whole number. In fact, it can also be negative. It is 
important though, that if your loop goes from a higher number 
TO a lower number, that you include the STEP command with 
a -1 or -2 or by however many you wish lo step backwards. 
Failure to give this command will generate an error. 
Example: 

FOR L00P=1 00 TO 1 STEP -2 
NEXT LOOP 

Now the computer will start with LOOP being 1 00 and work its 
way down 50 times, until LOOP is equal to 1 . 



Note that the only way the computer knows if its finished with 
the loop is if the variable is equal to a number outside of the 
range. In this example, if LOOP is greater than 100 or less 
than 1. Consequently, the loops stops AFTER it is out of this 
range. So when this FOR/NEXT loop is completed, LOOP will 
NOTequall.butO. 

Another goodie in MBasic are the IF/THEN/ELSE 
statements. These are used to make decisions in your 
program and take appropriate actions. 

IF and THEN go together like FOR and NEXT. The way they 
work is: 

IF (a condition is true) THEN (do something) ELSE (if the 
condition is false, do something else) 

An example of this is: 

IF X=Y THEN PRINT "X is the same as Y" ELSE PRINT "X is 
different than Y" 

You can also use formulas in the statement.. ..something like 
thiswill work also: 

IF (X-3+7/2)=(Y+2/3+7) THEN 



Also note that the mathematical functions (like -f, -, *, /) will 
be discussed in a future article. 

If you want to get fancy, you can put a whole slew of 
statements after the THEN command. Something like this 
will work. 

IF X=Y THEN PRINT "Yes, it's the samel": X=5: Y=7: PRINT 
X: PRINT Y ELSE PRINT "Nope, they're different!": X=2: 
Y=3: PRINT Y/2: PRINT X*3 

You can also use extra words in the IF/THEN statement. 
Two commands that can be tossed in are AND and OR. 
These let you test multiple conditions. 

You list out your conditions separated by either AND or OR- 
depending on what kind of results you need. If you use AND 
to separate your conditions then EACH condition must be 
true for it to execute the THEN. If you use OR, then at least 
1 condition listed must be true, before the THEN statement is 
executed. Example: 

IF X=2 AND B=3 AND Y=4 THEN PRINT "They were all right!" 

IF X=2 OR B=3 OR Y=4 THEN PRINT "At least 1 was right!" 

You can also combine them by confining certain decisions in 
parenthesis. Example: 

IF (X=2 OR B=3) AND 0=1 THEN PRINT "X could be 2 or B 
could be 3. but C DOES equal 1 ." 

Next month, I will go a little bit deeper into variables and 
other topics. 

•AC. 
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Inside CLI: Part 4 

by George Musser Jr. 

CC004049@BROWNVI\/I.BITNET 
CIS 76566,3714 



We have glanced at the insides of the Amiga's operating 
system in the last three parts of Inside CLI. This month, we'll 
kick around some of the AmigaDOS file utilities - tools that 
help you to examine and manipulate files. 

The Workbench disk comes with two file utilities: SEARCH 
and SORT. SEARCH will hunt for a text string; SORT will 
alphabetize a [ist. 

There are two ways you can look through a bunch of files for 
a lext string. You can pore over a stack of printouts and 
circle the words with a red pen. Or you can let the Amiga's 
fingers do the walking by calling on SEARCH. Searching is 
one of those tedious tasks at which computers excel. 
Writers want to locate citations or overused phrases. 
Bulletin board users wish to skim downloaded postings for 
key information. Programmers may need to find a particular 
subroutine lost in reams of source code. And so on. 

To begin a search, type: 

SEARCH <pathname> "<strlng>" (ALL) 

The <pathname> specifies which files to scan for directory, 
and it will look through all the files in that directory. You may 
also type out a pattern, a LIST. SEARCH examines files 
whose names match this pattern. The pattern may include 
special characters: 

? is called a wildcard, because it matches any 
character; 

#<p> matches zero or more repetitions of <p>; 

<p1 >|<p2> matches either <p1> or <p2> ; 

{) demarcate a pattern. 

For example; 

Year? matches Year1 , Year2, etc. 

Year#? matches Year, Yearl , Year2, Year12, etc. 

Year(1 12) matches Yearl and Year2. 



After the pathname, you put the search string. If the string 
is two or more words long, enclose it in quotes. SEARCH 
ignores case, so it treats "amazing" and "AMAZING" as the 
same. 

If you tack on the word ALL, SEARCH will scan the files in all 
the subdirectories as v/ell. 

As SEARCH progresses, it displays each file name. For 
each occurrence of the target, it prints out the line number 
and the line of text containing the string. As with all CLI 
commands, you can redirect the output, in order to save the 
outcome of the search in a file for later perusal (or posterity). 
For instance, to store the results of a search in a file called 
RESULTS, enter SEARCH > RESULTS etc. 

To abort SEARCH, press CTRL-C. CTRL-D stops looking 
through the current file and proceeds to the next file. 
Incidentally, SEARCH handles both text and non-text files, 
so that you can scan programs, too. 

Now that you've found whatever you sought, you may want 
to sort it. AmigaDOS includes a simple sorter named — you 
guessed it -- SORT. SORT puts the lines of a file into 
ascending ASCII order: punctuation first, then numbers, 
then letters. SORT ignores alphabetical cAsE. Type 

SORT <infile> <outfile> (COLSTART <n>) 

This will sort <infile> to produce <outfile>. If you want the 
output sent to the screen instead of to a file, specify "*" for 
<outfile>. 

SORT begins comparing in the first column, or column <n> if 
you specify COLSTART. Lei's say you have a mailing list: 

Hayes, Rutherford B. 43015 
Adams, John 02184 
1138,THX xxxxx 

Johnson, Andrew 27611 

If you SORT the list, you'll get the names in alphanumerical 
order: 

1133,THX xxxxx 

Adams, John 02184 
Hayes, Rutherford B. 43015 
Johnson, Andrew 27611 
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A GREAT COMPUTER... 

OUTSTANDING SOFTWARE... 
...AND INCREDIBLE PRICES! 



There may not be a better personal computer than the 
Commodore Amiga. But no computer can be better than the 
software thai runs on it. Micro-Systems Software, makers of 
Online! and BBS-PC tor the Amiga, proudly announce another 
link in their chain of value-packed software. 

Analyze! is a powerful electronic spreadsheet program. 
Essentially, this program isa lull-screen calculator where you 
can organize your data into rows and columns. These rows 
and columns can be analyzed with simple mathematics or 
complicated formulas. Rows and columns can be duplicated 
to avoid rc-typing. Both data and formulas can be edited with 
only a few keystrokes. 

From home budgets and check registers to financial 
modeling and your company's general ledger, all manner of 
bookkeeping tasks becom e faster and easier with Analyze I An 
outstanding value at only $99! 

OnUne! combines features and convenience in a high 
quality package that will meet all your telecommunications 
needs. With OnLinel, youcan useyour Amiga as a window to 
the world of information that is just on the otherside of your 
telephone. You can link up with commercial information 
services for stock quotes, airline information and 
reservations, technical databases, and thousands of other 
business and entertainment tasks. You can also plug into 
local bulletin board systems (DBS) and discover a new world 
of information and software for your computer. Corporate 
users can use Online! to let their Amiga access data stored on 
the company's mainframe computer. 

Online! is the finest program of its type available for the 
Commodore Amiga. You can't lose when you get "online" 
with Online!. Ail for a down to earth price of only S69! 

2400 bps modems! 2400 bps modems are breaking the speed 
barrier in telecommunications, and Micro-Systems is 
breaking the price barrier in 2400 bps m.odems. Transfer files 
2 times faster than a 1200 bps modem and 8 times faster than a 
300 bps modem. Micro-Systems will sell you a Hayes 
Smarlmodem compatible 2400 bps modem, a special Amiga 
serial cable, and a copy of Online!, all for $429. 

That's right, the modem, the cable, and the software, all 
you need to begin using your Amiga as a terminal to the 
world, priced at S429I Hundreds less than our compelilion! 



Micro- Systems Software, Inc. 

4301-18 Oak Circle 
Boca Raton, FL 33431 

(800) 327-8724/National, (305] 391-5077/norida 



Ask us about our Amiga bulletin board program, BBS-PC 
The first DBS for Amiga! 

'IK'GA, OnUnel, Analyze!, DBSPC, and Smartmodem are 
trademarks of Commodore-Amiga, inc., Micro-Syslems 
Soltware, Inc., and Hayes Microcomputer Products, Inc 
respectively. ' 



if you SORT with COLSTART 22, SORT produces a list 
ordered by ZIP code: 

Adams, John 02184 
Johnson, Andrew 27611 
Hayes, Rutherford B. 43015 
1138, THX xxxxx 

SORT reads the whole file into memory and works from there. 
If there's not enough RAM, the system will crash. Be sure 
your stack size is as big as the input file. You can check file 
size by typing 

LIST<{ile> 

and you can set the stack size with 

STACK <size> 

No matter what you do, you flirt with catastrophe if you try to 
sort files larger than 1 0,000 or so lines. 

A file of a lew thousand lines takes several minutes to sort. 
SORT seems to use a decent sorting technique, since 
sorting time appears to be proportional to n log n, where n is 
the number of lines. In fact, n log n is the theoretical limit of 
sorting speed. Any speed improvement would have to 
involve a better-written program. 

SEARCH and SORT come with the Amiga, but they are hardly 
the only file utilities at your disposal. We'll mention a few 
others available in the public domain. 

No one should be without Dave Haynie's DiskSalv, a disk 
doctor program available in Data Library six of 
CompuServe's Amiga Forum. DiskSalv reconstructs 
damaged disks, taking advantage of redundancies in the 
AmigaDOS filing system. You type 

DISKSALV DFm: (TO) DFn: 

DiskSalv inspects each block of the disk to rebuild 
directories and files. It then copies the files to a previously 
formatted disk in the other drive. DiskSalv works around 
disk errors and tries to contain the damage. (When I wiped 
out a whole track and AmigaDOS was unable lo read the 
disk, DiskSalv retrieved ail but one of my files.) 

Need more disk space? Compress your files with SO, 
available on AMICUS disk two. SO is an old CP/M utility 
written by R. Greenlaw, transferred to the Amiga by Rick 
Schaeffer, and modified by John Hodgson. SO can pack a 
file to as little as half its original size. Type 

SQ <file1><rfile2> ... <lilen> 

to squeeze filel, file2, etc. USQ reverses the process. SQ 
works by compressing strings of identical bytes. It then 
packs the file using Huffman encoding, whereby frequently 
used characters take up the least space. 
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If you need 1o see how two files differ, try Bill Joyce's DIFF, 
available on CompuServe. Tfie syntax is: 

DIFF<file1><file2> 

This version of DIFF isn't too robust; it chokes on more than 
about 10 differences. 

You can not ED binary files, but you can FILEZAP them. 
FileZap by John Hodgson is also available on CompuServe. 
It displays files in 256-byte chunks, with hex code on the left 
side of the screen and ASCII characters to the right. You 
can enter either hex or ASCII code to modify the file. 

With FileZap you can, for example, change the default CLI 
window size as mentioned in part two of Inside CLI. Enter 

FILEZAP CLI 

When the FileZap screen comes up, press 3 and carriage 
return. This sends you to the third 256-byte block. Using 
the cursor keys, move to address 64. Your current address 
is shown after "Loc:" on the right side of the screen. You 
should see "CON:0/50/640/80/New Cli Window" in the ASCII 
area. Press ' to enter ASCII characters and type the 
numbers you want. ESC exits modify mode. R undoes 
changes you've made on this screen. CTRL-C returns you to 
CLI. 

If you need a fancier SEARCH utility, you'll appreciate 
GREP, a Digital Equipment Corporation / DECUS utility 
converted to CP/M-80 by Chris Kern. The version of GREP 
in the Progs directory on AlVIICUS disk one does not parse 
quotation marks, so you cannot search for strings longer 
than one word. Fortunately, the source code in the C 
directory compiles under version 3.03 of the Lattice C 
compiler to a workable version of the utility. 

GREP offers a bit more versatility than SEARCH. To use it, 

enter 

GREP [flags] "<string>"<file1> ... 

The optional flags lets you customize the output of GREP. If 
you specify the flags, precede them with a hyphen. Flags 
include: 

c, which suppresses the printing of lines, giving 
you just a count of the number of occurrences of 
the search string; 

f, which turns off the printing of file names; 
n, which prints line numbers; 

v, which prints non-matching lines instead of 
matching lines. 




foi' tfve 

Take advantage of your AMIGA'S speaking poweis with THE ORATOR. THE 
ORATOR allows you to compose text in eilfier regular English, or using the Pho- 
neme method (or a combinalion of both). A complete text editor permits you lo 
change the spelling of words in order lo gel just the fight sound. You have com- 
plete control over the Rate, Pilch. Tuning, V'oice, and Mode ol each individual 
phrase by simple, mouse conlrolled sliding bars and boxes. A phrase can be any 
length up to 140 characters, and at least 200 phrases can string together in a 
single continuous tile. Your slory, poem, jokes, or whatever, along v;ith their voice 
sellings, can be saved in a compact sequential tile that you can use in your ovm 
BASIC programs. THE ORATOR also comes v/ith THE PHONEME TUTOR, a pro- 
gram that makes it easy lo learn the Phoneme method ol Icxt input. Includes 
complele documenialion and a utility program to/ use in your own programs. 
Requires the AMIGA wilh 512K memory, one disk drive, and ABasiC or Amiga 
BASIC. Both versions are included on the disk. 

Price: $39.95 postpaid COO.addSi 

(Indiana residenis add 5% sales tax) 

Mail check or money order to: 

TOE QUALITY COITAGE 

'^- 6301 F ijni\'Cirsit\' QHiimocis 

Suiln 308 

South B[;iid, In 4BG35 

I2i;i' 234-4401 

AWrGAiialf^flemaikol CommotJDre.-Amipa . I nc- 




Unlike SEARCH, GREP lets you specify patterns in the 
search string. Special characters include: 



^ matches line begin 
5 matches line end 

wildcard, which matches everything except a 
new-line character 
:a matches any alphabetic character 
:d matches digits 
n matches alphanumerics 
_ (colon-space) matches control characters 
<p>' matches zero or more occurrences of <p> 
<p>-i- matches one or more occurrences o{ <p> 
\<c> matches a special character <o 
[<p>] matches any character in <p> 
['^<p>] matches any character except those in <p> 
[<c1>-<c2>] matches characters from <c1>to <c2> 



For example: 

\$ matches $ 
[xyz] matches x, xx, xyz, etc. 
[^xyz] matches abc but not axb 
[a-z] matches a through z. 

SEARCH, SORT, DISKSALV, SQ, USQ, DIFF, FILEZAP, and 
GREP are but a few of the many tile utilities emerging for the 
Amiga. Most of these utilities are available only from CLI, 
giving you yet another excuse to experiment with CLI. 

•AC- 
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The Commodore Layoffs 

by John Foust 



On May 16, Commodore International, Ltd. laid off 140 
employees. According to an official announcement from Jay 
Miner, general manager at Commodore-Amiga Los Gatos, a 
uniform staff reduction was necessary to meet budget 
constraints. 

Winer explained the cuts. "The Amiga division's losses have 
come almost completely from management and engineering 
support services. Commodore and Amiga are continuing to 
support the Amiga computer, and development of new 
products is continuing at Amiga. 

"Except for a few people who quit a few months ago, we've 
lost almost no people in either the software or hardware 
engineering divisions. Those that we have lost have been 
basically quality assurance, management, and 
documentation. 

In conclusion. Miner said "the layoffs were necessitated by a 
need to meet certain budget figures." 

At Los Gatos, people were called on the phone, one by one, 
and asked to another room to discuss their termination. "It 
was horrible torture. You were obliged to sit by your phone all 
day," according to RJ Mical, past Commodore-Amiga 
director. Mical left Commodore-Amiga in January, but said 
he spent most of "Black Tuesday," as he called it, talking on 
the phone with his former co-workers at Los Gatos. 

"It was a reasonable, surgical strike. It's not that bad, it's 
upbeat," said Mical. f-Je explained the majority of the cuts 
were among those who weren't directly producing toward 
current goals, such as people in the accounting and 
purchasing departments, and lab technicians. 

Among the first of twenty people laid off at Los Gatos were 
Bob Pariseau, vice-president of software development. 
According to Pariseau, "I guess Commodore knew just how 
little I would support such actions, because I got mine in the 
first wave." Pariseau announced his departure on the BIX 
electronic network. Soon, the word flew to other networks. 

Rob Peck, Bob "Kodiak" Burns, Bruce Barrett, Stan Shepard, 
Sam Dicker, Barry Walsh, Howard Stolz and Rob Gemmel 
soon followed. 

These names are well-known to Amiga developers. Their 
names are listed in the credits of the source code used by 
developers. Many helped create the Amiga operating 
system, including Intuition and the Sidecar software. 

Gemmel is less-well known, but he contributed greatly to the 
external design of the Amiga, in packaging and case 
construction. 

Dicker was responsible for much of the development of the 
Amiga's sound and MIDI capabilities. He worked closely with 
Mimetics in the development of their Amiga music package. 



Paul Goheen, director of software in West Chester, resigned 
from his position on May 16. Goheen announced this on BIX 
and Compusen/e. Among many others, Jeff Bruette and 
Eddie Churchill were laid off from West Chester 

Carolyn Scheppner, a programmer in West Chester, reported 
no cuts in tech support there. The support group in West 
Chester is responsible for supporting all the Commodore 
computers, including the Amiga, 

The Dow Jones Newsvvire reported Commodore International 
had a third-quarter net loss of 36.7 million, versus 20.8 
million last third quarter, and sales were $182.3 million, up 
from $168.3 million. 

Several sources claim the introduction of the Amiga into the 
European market will make this quarter the best for Amiga 
sales worldwide. So far, sales are up this quarter. 

However, Commodore chairman Irving Gould told Dow Jones 
that U.S. operations have turned in a disappointing 
performance, due to high marketing expenses. In a May 20 
Wall Street Journal article, Goutd said those high costs are 
due to the Amiga and 128 computers. Gould also said sales 
of the Amiga were lower than expected. 

Gould told Dow Jones "the company has since implemented 
a series of actions to immediately reduce costs, including a 
manpower expense reduction in the U.S. of almost 50 
percent." 

In the same Dow Jones story, still-fresh Commodore 
president Thomas J. Rattigan said the company is striving to 
"break even" in the third quarter of this year, and he expects 
a return to profitability in the final quarter of 1 986. 

Rattigan said that special promotions featuring the Amiga 
should spur growth and sales into the fall, countering some 
rumors of a return to higher prices in the early summer and 
fall. 

The Wall Street Journal article quotes Charles Wolf, an 
analyst at First Boston, Corp. "I had assumed the company 
had pared down, but it hadn't. I think Rattigan is doing the 
only thing he can do, which is to shrink the company." 

A source close to Los Gatos claimed nearly 100,000 Amigas 
have been sold worldwide, as of late May. At the time of 
Spring COMDEX in Atlanta, in late April, Bob Pariseau 
thought 70,000 Amigas had been sold. 

In his network posting, Pariseau explained his future plans. 
"1 want to be where quality people are pushing beyond the 
edge of the art. Engineers with vision are still the best, the 
most forthright, and the most fundamentally interesting 
people I know. The vision that brought you the Amiga 
computer still lives." -AC- 
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FOTtlil : part three 



byJon Bryan 



I am really excited this month! After what seemed like an 
interminable wait, I've finally gotten not one, but TWO Forths 
for^my Amiga. First I was able to obtain the public domain 
Mountain View Press (MVP) version. It was very satisfying 
to finally see Forth's familiar "ok," but the sparse 
documentation was certainly frustrating. 1 did not have to 
suffer long though, because only a few days later I received 
a copy of Multi-Forth(tm) from Creative Solutions Inc. (CSI), 
and let me tell you, THIS is the one to beat. 

Creative Solutions has been in the business of supplying 
Forth for 68000-based computers for several years now. 
Their "MacForlh" for the Macintosh has been used to 
produce several highly-rated commercial programs. I use 
their implementation of Multi-Forth for the Hewlett-Packard 
"Series 200" computers at work, and have been very pleased 
with the documentation and support I've gotten from them 
over the last couple of years. 

Multi-Forth on a Hewlett-Packard computer is a very nice 
package, but Multi-Forth on the Amiga is a whole different 
aaimal altogether, and I mean that in complimentary terms. 
For one tiling, it must be 30% faster than it is on the H-P 
(which has a faster clock!), for reasons which I will soon 
detail further. 

But first a short digression. As I'm writing this there are two 
versions of Forth for the Amiga which are "reai" and available 
right now. Others are coming: you've probably seen the ads 
for UBZ Forth. I have a pre-release copy, but it wouldn't be 
fair to comment on it. Parsec Research, which produces 
"Superforth 64" for the Commodore 64, is working on 
something for the Amiga that should be out soon. The one 
other company which I know intends to implement Forth on 
the Amiga already has a version for tiie Macintosti called 
"Mach1," but they will not have an Amiga version ready until 
"sometime in the Fall." 

Back to the subject. I would like to make some observations 
on the two versions of Forth which I now have in my 
possession. There are fundamental differences in the 
methods which have been used to implement them, and by 
profiling those differences 1 may be able to offer some 
insights into the inner workings of Forth. 



Forth is known as a 'Ihreaded interpretive" language. 
Typically Forth is implemented using a scheme called 
"indirect" threading, in which the "compiled" form of a word is 
its address. Stored at that address within the word's 
definition is another address which points to a machine code 
routine which executes the word. The short code routine 
which "threads" its way from word to word is called NEXT, 
and it's the efficiency of NEXT which ultimately determines 
the speed of a given implementation of Forth. The 
"interpretive" label comes from the fact that what's compiled 
is an address rather than executable code. 

Although the method sounds cumbersome, in practice it 
turns out that threaded languages are quite efficient. Forth 
is fast, although not as fast as some other compiled 
languages or assembly code. Since all that is compiled is an 
address, indirect threaded Forth is also quite compact. 
While there are ways to implement Forth which are faster, 
they usually use more memory. It's the standard trade-off 
between size and speed that assembly-language 
programmers are familiar with. Mountain View Press's Forth 
for the Amiga uses a form of indirect threading, as do 
previous incarnations of Multi-Forth. 

So, you can either make your object code smail or you can 
make it fast, right? Not so, says Creative Solutions. It 
would seem that after several years of practice implementing 
Forth for various machines which use the Motorola 68000, 
they've come up with a different scheme which seems to 
have a number of advantages. 

What they have used is something called "direct token" 
threading. Not only is it faster than a 32-bit indirect threaded 
implementation, it's smaller as well. In older versions of Multi- 
Forth for systems like Hewlett-Packard's Series 200, the 
compiled form of a word was a 32-bit address. In the new 
Multi-Forth, what's compiled is a 16-bit "token." In Multi- 
Forth for the Amiga, NEXT uses the 1 6-bit token as an index 
to calculate a jump to executable machine code, bypassing 
the intermediate step of indirect threaded Forths. On a 
superficial level the big difference is that an indirect 
threaded version of NEXT takes three 68000 instructions, 
while the direct token threaded NEXT uses only two. A 
further improvement in speed is realized because a token 
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can be fetched with only one 16-bit memory access, while 
two 32-bit addresses have to be fetched in an indirect 
threaded scheme. 

There are many more ways to implement Forth than the two I 
have just described. Creative Solutions has told me that 
they considered over a hundred different variations before 
settling on the approach they have used. I do not think they 
were exaggerating, fvlountain View Press has used an 
indirect indexed form of threading for the sake of portability 
which restricts applications to 64K of memory. (To be fair, I 
should point out that fvluIti-Forth will slow down if an 
application grows larger than 64K.) "Subroutine" threading 
was chosen by UBZ for their implementation. Machi uses a 
combination of subroutine threading and "macro substition" 
on the Macintosh. I will not get into that unless and until they 
actually come out with something for the Amiga. Ever/ 
approach involves some compromise, since the 68000 was 
not designed with Forth in mind. 

There are a number of other differences between MVP-Forth 
and fVlulti-Forth. 1 have not had time lo compare them 
extensively, but I will try to describe what I have found so 
(ar. There is a big difference in philosophy between the two. 
Mountain View Press feels that portability is very important, 
so their Forth for the Amiga does not take advantage of 
many of the machine's features. In trade you gain access to 
a large body of programs written in N^VP-Forth covering a 
wide range of applications which should run virtually 
unchanged on the Amiga. Creative Solutions, on the other 
hand, has written a powerful development language which is 
optimized for speed and includes lots of hooks into the 
Amiga's Kernel routines, but which will be considerably less 
portable as a result. 

Another difference between MVP-Forth and Multi-Forth is in 
the way source code files are handled. Forth source code is 
traditionally organized in units called "screens" (or blocks) 
which are 1024 bytes long. Many Forth programmers swear 
by screens and make a lot of claims about their superiority to 
text files. I've always used screen-based Forth systems in 
the past, and I've been reasonably satisfied. They do tend 
to enforce some discipline, encouraging small definitions 
and belter organized code, but few screen-oriented Forth 
implementations that I've seen had very good editors. 

While MVP and CSI both put all source code in normal text 
files, the MVP-Forth editor breaks up the file into 1024-byte 
screens. Creative Solutions" approach was to give you the 
whole file and let you use any editor you wish ("ed" is a Multi- 
Forth word which calls up the AmigaDOS screen editor). For 
the real diehards CSI includes extensions which provide a 
block environment and editor. 

I'm inclined to believe that dispensing with screens is the 
smart thing to do on the Amiga, being forced to that 
conclusion by the harsh realities of peacefully coexisting 
with AmigaDOS, Intuition and all of the ROM Kernel routines. 
Since they're all written in C, there are certain aspects of 
their structure (namely Structures themselves), which make 
a traditional Forth screen environment uncomfortably 



restrictive. You simply can't avoid persistently crossing 
screen boundaries. While it might not be "good" Forth, you're 
forced to do it, and rather than put up with that kind of 
awkwardness I think its better to dispense with screens 
altogether. (Now I am going to sit back and wait for the nasty 
letters to come in.) 

There is also a considerable difference between MVP-Forth 
and MuIti-Forth in their support for AmigaDOS. MVP 
provides very little support for DOS routines, while CSI 
allows any DOS function to be called from the Multi-Forth 
environment. Multi-Forth allows the most common DOS 
routines to be used just as if you were in the CLI, while the 
rest have to be prefixed by the Forth word "CLI". That means 
you can type "dir df1;" directly, but you have to type "cli list 
dfl;". If you want to avoid the use of "cli" entirely you can 
easily create your own definitions for those DOS words 
which are not supported by default. The details are in the 
manual. (For the confused: I used "CLI" in both upper and 
lower case because Multi-Forth by default is case 
insensitive. You can change that, though.) 

The biggest difference between Multi-Forth and MVP-Forth is 
that you can get MVP-Forth free, but Multi-Forth will cost you 
$179 retail. It is reasonable to expect a lot more bells and 
whistles when you are paying for them, MVP-Forth is really a 
form of advertising for Mountain View Press, and it includes 
a disclaimer which says it is not optimized, and is intended 
only to introduce you to the language. MVP will sell you a 
Programmer's Kit for $175 which includes the disk, 
documentation, and four books (one of which is the excellent 
"Starting Forth" by Leo Brodie), but you still won't have the 
kind of development system Creative Solutions is providing. 
There is nothing to stop you from creating your own based on 
MVP-Forth, if you've got lots of time, patience, and 
documentation. That's the beauty of an extensible 
language. 

I apologize if my column this month sounds like an 
advertisement for Creative Solutions, but I'm impressed. 
The tremendous complexity of the Amiga's hardware and 
"firmware" make developing a programming language for the 
machine a particularly difficult problem. I can't help but 
admire anyone who even dares to try, and Creative Solutions 
has not only succeeded, they have done a fine job of it. If 
you intend to develop software for the Amiga, Multi-Forth is 
definitely going to be agood language to do it with. 

1 could really learn to love this machine. How many 
computers allow you to run more than one LANGUAGE at a 
time? I'm writing this from ED (for lack of a word-processor), 
have both Multi-Forth and MVP-Forth loaded, and 
simultaneously have the printer going typing out a draft copy 
of this article. I've had BASIC playing Bach in the 
background while I'm writing, and had Forth running a 
graphics demo at the same time. Someday this sort of thing 
will be commonplace: today it's simply mind-boggling. But if 
there's one thing I'm certain of, it's that 51 2K isn't enough! 

•AG- 
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The Amazing C Tutorial: 
part five , , 



Manx review: part two 
by John Foust 



John Is continuing the review of Manx Aztec C for the Amiga 
from last month, (ednote) 

Comparison of Manx and Lattice compile times, compiling 
Miciiael Mounier's terminal program 

To compare compile speeds for larger programs, I used the 
Amigaterm telecommunications program by (vlichael Mounier. 
This is roughly 32 K of source, with a large amount of 
'#include' files. It is one of a dozen or so example programs 
provided on disk two of the Manx system. 

The Manx times reflect using the 'make' utility, with simple 
non-substituting rules. Lattice times reflect using a simple, 
four-line EXECUTE batch file. 

For on-disk library times, the reside in DFO:, while the code is 
in DPI :. The DPI : is about 90 percent full - somewhat typical 
in a programming environment. 

For the pre-compiled '.h' file time in column three, it took 1 :15 



Listing A 

Manx 



Lalllce 



Manx 
libs on 
disk 
FASTER switch 

'cc'or'IcV 0:15 
starts (1:15) 

'as' or "102' 1:30 
starts (1:00) 

'In'orAlink 2:30 
starts (3:20) 



Manx libs in RAM:, libs on disk, 

libs in precompiled Lattice with Alink 
RAM: ,h files libs on disk 



0:15 
(1:15} 

1:30 
(1:05) 

2:35 
(1:00) 



Compile ends 5:50 3:35 



0:15 
(0:30) 

0:45 
(1:10) 

1:55 
(1:10) 

3:05 



0:20 
(2:40) 

3:00 
(0:45} 

3:45 
(2:45) 

6:30 



0:20 
(2:40) 

3:00 
(0:45) 

3:45 
(1:45) 

5:30 



Resulting load file size 

Manx: 13,554 

Lattice: 26,440 (27,496 before StripA) 



minutes to pre-compile the .h files, resulting in a 49912 byte 
symbol table file, which was written to disk. This small, 1 133 
byte source file was created by writing the top of the file to 
disk, as a separate file on DPI :. 

1 can't supply a compile time with the Lattice libraries in 
RAM:, since there isn't enough room for it all in a 512 K 
machine. With source code on DF1:, and writing the '.q' file 
to DPI:, 'Id' took over ten minutes alone, but this is a fault 
of slow disk access, not Lattice. 

The time in parentheses is the completion time for each 
phase of the compile and link sequence. Times are an 
average taken over several trials, and seemed to vary by up 
to three seconds, presumably due to disk access, too. 



Manx utilities 

As you'll see, the Manx utilities will be familiar to Unix 
programmers. Most are direct clones of the most popular 
Unix tools. 

acvt: This converts standard Amiga object files to assembly 
language source compatible with the Manx assembler. By 
"standard Amiga object files," 1 mean the result of the 
Metacomco assembler or the Amiga object librarian. 

This quietly turns the Lattice-supplied libraries, such as 
'amiga.lib', into dozens of short assembly language files, 
compatible with the Manx assembler. In this case, each 
program just sets up registers before and alter making a call 
to a WCS function. 

adump: This displays information about Amiga object files or 
loadable modules. It displays a series of hex bytes for 
hunks in an Amiga object file, and can optionally display 
each code or data block contents, and symbol names. 

arcv, mkarcv: These are simple 'ar'-type archivers for text 
files. Not to be confused with the ARC file compression 
program from the IBM world, 'arcv' packs text files together 
in a lump, with no compression, 'mkarcv' will create a new 
archive file, 'arcv' takes it apart. 

These programs are used to archive the source files for the 
Aztec libraries supplied with the Commercial version. The 
source code is only included in the commercial version of 
the compiler. 
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cmp: This is lil<e the Unix binary file compare utility of the 
same name. Normally, this comes up with a message such 
as "files differ at byte N". Optionally, it can display a list of 
offsets into each file, and the differing values. 

db: This is a yet-unfinished symbolic debugger. The Manx 
manual promises more documentation at a later date. I hope 
Manx adds some good documentation of the uses of 'db'. It 
looks tantalizing, and could doubtless sell well as a 
separate product. 

'db' can read symbol tables from a program load file. There is 
a '-W' option for the linker to include these symbols. 

It has a nice set of instructions. It lets you select a task 
from the current task list, single step, disassemble, and 
display an expression in several forms; hex, decimal, octal, 
binary, as a signed number, or ASCII, 

Expression entry can use symbols, so you can type 'u pc' to 
start diassembly at the place where the PC register points. 

A good part of it is obvious, such as disassembling memory. 
But the 'ai' command, for instance, dumps a cryptic 
screenful of data about the currently selected process. 

It takes a second or third look to realize it is displaying the 
data in the most important slructs used in process control, 
and that the mneumonics in Ihe dump are shortened 
versions of the struct member names. 



Come to think of it, 'db' comes with about as much paper 
documentation as Wack, but the program's internal help is 
much more helpful than Wack's. 

cnm: This displays information about object modules, such 
as the size and symbol names for segments, and whether 
they are for code, data, initialized or uninitialized, and the 
sum of the sizes of the hunks. 

diff: This is like the Unix text comparison program. Given 
two files, it finds the places where they differ, and sends 
this difference to standard out. 

grep: This is yet another Unix utility, which can search for 
regular expressions. Fortunately, this means Unix-type 
regular expressions, and not the wacky ones used in 
AmigaDOS/TRIPOS. 

For the uninitiated, a regular expression is a method of 
specifying a character string. For example, you can ask 
'grep' to print all lines in a file that begin with "int", or all lines 
that contain words that start with "a". 

hd: This is a hex dump utility, you can also specify an offset 
into file, and it will begin dumping at that point. 

lb: This is an object file librarian, for Manx object files only. 
You can create new libraries, add modules, list modules in a 
library, or move an object file within a library. It can delete or 
replace object modules, and also delete non-unique 
modules. 
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Since the linker searches 1or modules in a single pass, you 
might want to rearrange the order of modules, with the 'ord' 
utility below. 

make: This is sometimes described as a program 
maintenance utility, but 'make' has many uses, and thai 
name only attempts to cover them all. Its most common use 
is to recompile only the source code tiles that have changed 
since the last compile and link, and then supervise the 
linking of the program. 

This 'make' has simple $FOO macro expansion, including 
special macros $@ and $*, which can break up a target file 
name into name and extension. 

obd: This utility will list the loader items in object file. 

ord: This can sort an object file list. The basis of the sort is 
on reference dependencies within object module, so this will 
minimize backward references, which would make the object 
library be searched again during a link. 

set: This can set or clear Manx's environment variables. 
Library functions include getenv() and putenv() calls, which 
can access these environment variables. 

An environment variable is a string stored in system memory 
which is undisturbed by programs - sort of like your settings 
in Preferences. 

For example, typing "SET CLIB=RAM:" will create an 
environment variable named GLIB, and it will be set to RAf^:. 
The linker will check the value of GLIB, using the getenv() 
function, and search the RAM: disk for object libraries, 

setdate: This forces entry of the date and time from user. 
The documentation claims it allows the entry of 03/28 for the 
date, which accepts the present year as the default, but I 
couldn't get this to work. 

z: '2' is a Unix 'vi'-like editor. If you are not familiar with 'vi', 
it is a mode-driven, cryptic editor, which includes such 
features as multiple fi!e editing, 'undo' and macros. As a 
friend says, "'z' is as good as 'vi'. or as awful as 'vi', 
depending on how you look at it." 

The 'z' edit window does not take advantage of the Amiga 
window environment, beyond having front/back gadgets. 
Unfortunateiy, the 'z' edit window cannot be resized. It is 
limited to editing files smallerthan 58 K. 

Interestingly, it can't handle files with lines terminated with 
just carriage returns. It crashes in the same way as the 
public domain MicroEmacs, when faced with a file on this 
type. 

It you aren't aquainted with 'vi'. it's pronounced 'vee-eye'. 
Some people prefer to say it 'vi', to rhyme with 'eye'. It is a 
screen editor driven by single- and double-character 
sequences, each of which pop you into a new mode. 
Pressing 'i' brings you into insert mode, and ESC gets you 
out. 
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For example, the keys 'h', 'j', 'k', and 'I' are the cursor 
movement keys, while out of insert mode, 'h' goes left, 'j' 
goes up, and 'k' goes down, while T moves right. 'L' means 
right, get it? Fortunately, the Amiga arrow keys work. too. 
Actually, the standard 'vi' cursor movement keys are easy 
to use, once you get used to Ihem. 

Ctags utility 

'z' also has a 'tags' function, an easy way to jump between 

the source files of a multi-module program. 

To do use this, you need to run the 'ctags' utility. This 
program scans a set of G source programs, and produces a 
file named 'tags', which contains a list of the function names 
and the files they are in. 

Place your cursor on a function name, and press CTRL/right- 
square-bracket. The editor will begin editing the source file 
that contains that function, place your cursor on that 
function's code declaration. 

However, this 'tags' is a little fussy about what it considers a 
valid function declaration. It requires the function's return 
value type placed on a separate line, before the name of the 
function itself: 

int 

(oo() 

This might go against a programmer's personal style of 
formatting declarations of functions. 'AC* 
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Scrimper: Part two 

by Perry Kivolowitz 



This is part two of the description of scrimper, a screen image 
printer. In part one appearing in last month's Amazing 
Computing, I gave you the scrimper user manual as well as a 
detailed description of the construction of printer.c, one of the 
two modules in scrimper. 

This month I will describe the other module, scrimper.c. This 
module handles the interface to the user via Intuition while the 
module described last month deals only with the mechanics of 
actually getting a selected screen printed. 

What will be of interest in the lollowing discussion is the use of 
Intuition menus {and how one might pretty them up a bit) and 
the use of a fancy C language construct (pointers to 
functions). In the time since scrimper was developed I've 
noticed a few deficiencies in its code so I'll point these out as 
we get to them. 

For example, three of the included header tiles are not 
actually needed. These are dos.h and dosextens.h from the 
directory "libraries" and startup.h from the include directory 
"workbench". These headers were needed by an earlier (and 
in fact a later) version of scrimper but are not used in this 
version. 

Next I declare two manifest constants and two short-hands. 
The window width (WWIDTH) is declared to be 640. This 
corresponds to the width in pixels of the standard workbench 
screen. This is to say that the default workbench screen is a 
"HIRES" screen. Making a workbench screen 60 columns or 
80 columns does not change how many pixels there are 
across the screen (that's constant at 640). What does 
change is the number of pixels each character consumes (the 
80 column font is narrower than the 60 column font). 

MAX_SCREENS is simply the maximum size of an array 
which will keep a pointer to each active screen structure. The 
list could have been set up dynamically, but doing so just 
didn't seem worth the effort. 

SIZE_MI and SIZE_IT are just short-hands standing for the 
size (in bytes) of a Menultem and IntuiText structure 
respectively. This is an example of using the C preprocessor 
as a means for saving key strokes later on. One thing to note 
is the seemingly redundant parenthesis. In fact, in this case 
the parenthesis are technically not needed but it is a very 
good habit to be in to parenthesize heavily when using the C 
preprocessor. 

As a real quick explanation as to why you should 
parenthesize C preprocessor expressions heavily just look at 
the following definition: 

#define SQUARE(x)x * x 



Now invoke SQUARE with "5 -t- 5" as an argument. What we 
expect as a result is 100 (10 ' 10) but.. .what do we actually 
get and why? 

Next, I lie to the C compiler in declaring a few external 
functions. When this module was written (many months ago) it 
wasn't clear to me just how to declare such staple routines. In 
fact, it still isn't quite clear but it doesn't really matter. 
Declaring something to be a function returning a pointer to a 
"void" is a handy way of reducing the number of bogus 
warnings about mixing pointer types. 

Notice that when I actually use a routine like OpenLibrary, I 
cast its result to precisely the type of pointer I desire. No 
muss, no fuss. It is, however, critical to declare a function 
returning a pointer as a function returning a pointer. With 
many compilers on many machines this is not so important 
since a pointer is the same size as an integer, but on the 
Amiga, especially when using MANX C, this is not so. A 
pointer is a 32 bit quantity while an integer may be 1 6 bits. 

I declare our good friend "calloc" to be a function returning a 
pointer to bytes, which in fact it is. And, our good friends 
IntuitionBase and GfxBase. On the Amiga, libraries are 
accessed off of base addresses which are dynamically 
assigned. This way. no status address need be defined as in 
some very simplistic microcomputer operating systems which 
predate the Amiga. 

GfxBase and IntuitionBase must be initialized by calls to 
OpenLibrary and must be declared as having exactly those 
names. This is because the "glue" code which binds the C 
language 1o the libraries reference symbols with those names. 
Defining one symbol with a specific name buys us the luxury 
of not having to remember or hardcode dozens of entry points 
into the Amiga kernel. 

The declarations of such routines as generic_cleanup and 
func_init are more examples of lying to the C compiler. I say 
they are "extern's" but they aren't really. I declare them in 
this way at this point so that the compiler will understand that 
these symbols refer to integer functions when I use their 
addresses to initialize some structures coming up. 

Next come some IntuiText structures, the structure of 
which I described last month. Worth mentioning again is the 
cast to "UBYTE *." This is equivalent to casting to pointers 
to unsigned char's. The typedef is provided by the MANX 
header file "exec/lypes.h." There are analogs under Lattice. 
The cast is needed because Amiga defined the IntuiText 
structure to expect an unsigned character pointer instead 
of a normal character pointer. Who knows why, since 99 
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percent of the time, programmers will just load a character 
string into this field. 

Notice that in each of the IntuiText structures the LeftEdge 
field is left as a 0. Having a LeftEdge of is-ok per-se but we'll 
ge! a little fancy later on and poke some values into each 
LeftEdge at runtime. The three IntuiText's represent the text 
to be displayed on "function selection" menu which is put 
up after the user has selected a screen to work with. 

The little bit of fanciness will be that need to display the menu 
items centered in the middle of the menu. There are two steps 
involved in the centering process. First, find out how wide 
each menu item is and how wide the widest one is. Second, 
run through the list of menu items adjusting the LeftEdge 
field in each IntuiText structure so as to center each text in 
the space required by the widest text. 

The routine "set^widths" takes as its argument a pointer to a 
Menu structure. It simply runs the list of Menultems starting 
with the Menultem pointed to by the Menu structure field, 
Firstltem. For each Menultem, I fill in the Width (Menultem- 
>Width) of the IntuiText structure pointed to Menultem- 
>ltemFill. 

The call to IntuiTextLength takes care of figuring out exactly 
how many pixels a given string will occupy in a given font. The 
font, of course, can be determined for each IntuiText 
structure since one of the fields in the structure is a pointer to 
a text attribute structure. 



In the routine "massage_left_edges" we again accept a 
pointer to a Menu structure. We'll run the list of Menultems a 
second time to determine the width of the widest item. This 
loop could have been combined with the loop in set_widths 
and in fact, should have been. But, since the number of 
elements in the list (three in the case of the function selection 
menu or the number of active screens in the screen select 
menu) is vary small, the cost of the extra tour through the list 
is not high. 

Once we've determined the width (in pixels) of the widest 
entry, we run the list of Menultems one more time to center 
each item within the field defined by the width of the widest 
item. This is done by dividing the space left over when you 
subtract the width of the current Menultem from the width of 
the widest Menultem into two equal fractions. 

For example, if the widest Menultem was 100 pixels wide, and 
the current Menultem was 60 pixels wide, there would be an 
excess of 40 pixels. Divide this by two to get 20 pixels of 
space on either side of the 60 pixel Menultem. Just plug the 
result into the LeftEdge field of the IntuiText structure and 
Pooof ! Instant centered menus! 

One step that remains for each Menultem is to set its Width 
to that of the widest item. This way each menu items' 
selectable area will be the same size and will give the menu a 
visually appealing construction. 

I've been talking a good deal about Menultems, Menus, and 
such. Let me spend a few moments to explain how these 
structures interrelate to construct menus on the Amiga. 

At the top of the menu pyramid is the Menu structure. This 
structure is sort of a menu header in that there are one of 
these for each menu you will construct. If it is possible to 
select from one of several menus at any one time, each of 
these menus will be represented by a Menu structure in a 
linked list of such structures. 

The Intuition call SetMenuStrip takes a pointer to the first 
element of a link list of Menu structures as well as a pointer to 
a window to associate the menus with. As you know, when the 
right mouse button is depressed after a valid SetMenuStrip 
call, a menu strip appears along the top most portion of the 
window. 

The text which appears within the menu strip for each menu is 
defined by the MenuName field in the Menu structure. The 
position of the text and hence its selectable area is defined by 
the LeftEdge and Widthfields. The other obligatory fields, 
Height and TopEdge are not used for anything at this point. 

The linked list of Menu structures is maintained by the 
NextMenufield. This field is, of course, defined as a pointer to 
a Menu structure. The field Flags can be initialized to 
MENUENABLED or not. If not, the text in MenuName will be 
drawn but will be drawn in a ghosted fashion. If the user 
attempts to select the ghosted menu, no action will take 
place. 
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This leads us to the field Firstltem. Firstltem is a pointer to a 
structure of type fulenultem. Think of Menu structures as 
representing the names of menus while f\/1enultem structures 
as representing the items within each menu. As a side note, 
Menultems may themselves be broken down into sub-menus. 
Currently the limit to this recursion is one level. 

For example, a Menu structure might represent "Beverages." 
One of the items under this menu (represented by a 
Menultem) might be "Coffee." A sub-Menultem might be 
"black" another might be "Light and Sweet." 

Menultems define only the selectable area within which this 
item will be considered to have been chosen by the user. The 
actual text for the item is stored as an IntuiText structure and 
is pointed to by the Menultem structure by the field ItemFill. 

Notice that ItemFill is of type APTR (or "a 'generic' pointer"). 
This is because Menultems can also point to images as well 
as IntuiText structures. That is, if we wished we could have a 
menu of pictures instead of a menu of text. Or, of course, we 
can mix and match. In Scrimper, we use only textual 
Menultems. 

In view of this brief discussion of menus, if you wish, go back 
and re-read the discussion on massage_left_Gdges and 
set_widths. 

Recall that when using Scrimper there'll be two menus. One is 
static in nature in that its content is hard coded into the 
program source code. This static menu conveys to the user 
his choices of what to do with a screen once one has been 
chosen. The other menu (presenting a list of active 
screens) is built dynamically. 

There are two ways a data structure can be built under 
program controi. One can either hard code the structure as in 
the case of the static menu or one can build the structure at 
"run time," that is, when the program is actually executirtg. 

(Actually, there are two ways to build a structure dynamically. 
One way is on the execution stack the other is from memory 
allocated from a "heap." Variables defined on the stac!< are 
transient In nature and can be thought of as temporary local 
variables. 

The "heap" is the set of memory which can be added to your 
program's address space on the fly. Variables declared on 
the heap are more permanent in nature in that they will sticl< 
around until specifically deallocated by the program. 

Stack and heap born variables differ in another way. A stack 
based structure is declared to have a specific size and shape 
by actually having C language local variable declarations in 
your source code. Heap variolas are declared in a two step 
process. 

First, a pointer to the structure to be created must be 
declared in some way. Then, the space actually used by the 
structure is allocated from the heap by some memory 
allocating function. In Scrimper, I use the routine "calloc" for 
heap allocation. Calloc. by the way, is a UNIX ((trademark of 
Bell Telephone Laboratories, Inc.)) function call so firmly 
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embedded in the C programmer's mind that most non-UNIX C 
compilers provide the function to avoid nasty letters. 

The pointer is set to point to the start of the region reserved 
by the call to calloc. There alter, dereferencing the pointer 
gets you the structure.) 

The routine ""build_menu" is called often in Scrimper. In fad, 
I call it as often as possible since it builds the list of current 
screens and 1 want this list to be as current as possible. 
Build_menu calls "'alloc_menu_item" once for every screen 
found to currently exist. 

Alloc_menuJtem is the routine which allocates tfie memory 
needed for one fyienultem structure. Notice that Vne iirst 
argument to alloc_menu_i(em is declared as a "star star" and 
not as a single "star." This is read as"a pointer to a pointer 
to a structure of type fvlenullem." 

Remember, that whenever you want a subroutine to lastingly 
modify an argument, you must pass tfie argument as a 
pointer. What if what you wanted the subroutine to modify 
was itself a pointer? Well, just pass a pointer to the pointer. 

The first thing alloc_menu_item does is to call calloc asking 
for enough space for one instance of a structure of the same 
size as a Menultem. Notice that calloc is casted to the 
appropriate type before its result is assigned to "star p." 
This is because calloc is initially declared as a routine which 
returns a pointer to bytes (characters) not Menullems. 

We assign the result (a pointer to a fi^lenultem) to "star p" 
because it is the pointer to the structure. P by itself is a 
painter to a pointer, P with a single star is a pointer, and P 
with a double star refers to the structure itself. 

The pointer to the structure ("star p") is checked against 
NULL which is what calloc would return if the reservation of 
heap space failed for some reason. If calloc returns a non- 
NULL value, we can go ahead and use *p as an ordinary 
pointer to a structure. 

Notice we immediately initialize the linkage field, Nextttem, 
to NULL. We do this to ensure that we can accurately find the 
end of the linked list whenever we need to run it. 

The height of this Ivlenultem will just be the size of the default 
font for the current window (this assumes, of course, that a 
window had been opened previously). Since all my menu 
items are declared as having the same height, 1 can easily 
compute the TopEdge field as being a multiple of the height 
field. The parameter "i" is passed in containing the multiplier 
to the height field. The first lime alloc_menuJtem is called i is 
0. The next time, i is one and so on. This way, each 
succeeding call to alloc_menu_item creates an item further 
down the menu. 

I set the LeftEdge field to -5 in every case. I do this to set up 
a pleasing amount of overlap between the actual menu 
itself and its header text up on the menu strip. 

Next I fill in the Flags field with some critical bits. First is the 
ITEMTEXT flag which tells Intuition that the thing pointed to by 



ItemFill is an IntuiText and not an Intuilmage. ITEfulENABLED 
tells Intuition to allow the user to select this item from the 
menu. If this bit is not turned on the item will still appear in the 
menu but will appear ghosted and cannot be selected by the 
user. 

The last flag I set is HIGHCOMP. This specifies the style of 
highlighting I want to use to provide feedback to the user 
indicating which item from the menu Intuition currently thinks 
the user is pointing at. HIGHCOf\/lP causes Intuition to 
compliment the select box of an item whenever the mouse is 
positioned over the select box. Other choices include 
HIGHNONE which asks Intuition not to highlight at all and 
HIGHBOX which highlights by drawing a box around the 
currently selected text. In my experience, HIGHCOfvlP is 
the most pleasing form of highlighting. 

The Command field is filled with indicating to Intuition that I 
don't want to define any keystroke short cuts for getting to a 
menu item. If I had loaded an ascii character (a character from 
the keyboard) into Command, and set the COMfvlSEQ flag 
in the Flag field. Intuition would accept right Amiga-with-the 
character as identical to pushing the right mouse button and 
selecting the item. 

When using amiga-key menu shortcuts you must remember to 
enlarge the select box of the menu item to make room for 
Intuition to render the symbol for the short cut. The symbol 
will be displayed on the same line as the menultem it stands 
for whenever the menu is drawn. In this way, the user will 
constantly be reminded what the short cuts are. 

The next field to be filled in is Subltem. 1 fill this NULL because 
I don't want any of Scrimper's menu items to enable the 
displaying of a sub-menu. Recall the previous example of how 
sub-menus might be used. The menu header might be 
Beverages. A menu item might be Coffee. A sub-menu might 
display the choices you have as to what to mix into the 
coffee. 

The Subltem field is of course a pointer to a structure of 
type Menultem. If Subltem had been initialized to point to a 
Menultem structure, that item (and any item pointed to by 
'that' item through its Nextltem field) would be rendered 
whenever the mouse was positioned over the original 
Menultem. 

The NextSelect field is also initialized to zero. We'll talk 
about this field when we discuss the actual mechanics of 
using menus. 

The MutualExclude field tells Intuition which menu items 
cannot be selected at the same time this item is selected. 
The way this works is, each item in the menu is assigned a bit 
in the MutualExclude field. Item 1 gets bit 0. Item 2 gets bit 1 
and so on. If a bit is turned on in a MutualExclude field it 
means that that item cannot be selected when this item is 
selected. 

In Scrimper, every item mutually excludes the others in the 
menu. So, I initialize each MutualExclude field to exclude 
(have a bit turned on) every other item. This is done by taking 
the one's compliment of a single bit in their place. The size of 
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MutualExclude is 32 bits so the net effect is to have one off 
bit (representing tfiis item itself) and 31 on bits representing 
all other Menultems. 

Since the MutualExlude field is 32 bits long, only tfie first 32 
(of potentially many more total items) in eacfi menu can be 
tested for mutual exclusion. 

Now it is time to declare (dynamically again) the space for the 
IntuiText structure which will contain the text for this menu 
item. For this I call the routine allocjntuitext passing it a 
pointer to a pointer (why?) and the string I want the IntuiText 
to hold. 

The test against string length being odd is not really needed 
since calloc will take care of allocating an odd number of 
bytes. Star p gets the value returned by calloc when asked to 
reserve enough bytes for an IntuiText. If calloc returns NULL 
then no space was available and the NULL value of star p will 
signal alloc_menu_item that something is amiss. 

If the calloc of the IntuiText structure went ok, I declare 
enough space to hold the string I want the IntuiText structure 
to point to. If this second calloc is NOT successful I set star 
p to NULL in the "else" portion of the if statement. As in: 

if(d){ 

blah blah blah 
} else •p = NULL; 



This is correct to tell alloc_menu_item that something went 
wrong. However, I forgot to do something right? What'd you 
say? Thai's right! I forgot to release the storage I had 
successfully allocated in the previous call to calloc. The code 
should look like: 

if(d)( 

blah blah blah 

} else { 

r give back the intuitext structure V 

free('p); 

*p=NULL; 

} 

This bug would cause a tiny amount of memory to be lost 
whenever Scrimper was run when not enough memory was 
available. This oversight, though not serious, is an example of 
creeping memory loss which can plague an Amiga system. 

If we have allocated the space for the Intuitext structure as 
well as space for the text to be stored we go ahead and 
initialize the fields in the IntuiText structure. In case you're 
wondering why I buffer the text (which in Scrimper is actually 
the names of screens), what would happen if I made the 
IntuiText structure point to a screen name directly and the 
screen was closed by the user (and then a menu was 
displayed)? 

In last month's discussion we talked about what each 
IntuiText field does so we won't repeat that here. 

At this point we've declared and initialized everything we 
need for one menu item. We return from allocjntuitext with 
star p "NOT' being NULL. We return to alloc_menu_item and 
test the ItemFill pointer (star p in allocjntuitext) against NULL 
to see if the allocations had been done successfully. If not, 
what oversight did 1 commit a second time? 

If the allocations had all gone ok we fill in the Width field of the 
fi/lenultem by calling IntuiTextLenglh with the ItemFill (a 
pointer to an IntuiText). Later on we'll call 

massagejeft_edges to center each item within the menu as I 
explained earlier only here, of course, we won't have to 
callset_widths since the widths are already defined. 

We'll conclude the discussion of Scrimper next month where 
I'll talk about pointers to functions and how they're used to set 
up generalized handling ol various events. 

•AC- 
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merging from years of successful problem solving 
applications in piping, and electronics for the aerospace 
industry, DYNAMIC CAD has brought a highly advanced 
and powerful CAD system together with today's most dynamic and 
versatile micro-computer, the Amiga. DYMAMIC CAD takes fuli 
advantage of Amiga's extensive capabilities with color, multiple 
modes of resolution, mouse functions, and easily accessible 
pull-down menus. 

This is not some promised "vapor-ware." DYNAMIC CAD exists 
now and comes to the Amiga with a proven track record. The time 
and money-saving applications of DYNAMIC CAD for engineers and 
architects are truly astounding, hiere is an advanced, 2-D drafting 
system with isometric capabilities that can be combined with many 
models of printers, plotters, and digitizers. In getting started you'll 
have the support of an extensive manual written in understandable 
English along with working examples as tutorial lessons. 
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• D'C can produce isometnc views. 
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(Marauder: a review ByRickWirch^ 



It is very reassuring to buy a product tfiat performs as advertised. 
Marauder is such a product. Marauder provides arcliival backups for 
most copy-protected software on the market today. 

How important are archival backups? It depends upon how much you 
value your software. I have had two bad experiences with copy- 
protected software and fVlarauder removed my fears (hat my software 
could be lost. 

By providing a' backup o! your software, any mistakes caused by 
inadvertent keystrokes or mouse clicks will alter only the backup, 
while the original is stored in a safe place. 

I have been using and writing programs for personal computers for the 
pastsix years. No matter how careful you are, mistakes are possible. 

One mishap was as simple as an inadvertent menu pick that saved a 
file to my copy-protected Deluxe Paint disk. That file now cannot be 
deleted, and my faith in the integrity of the file staicture on that disk is 
low. 

Unfortunately, this mishap occurred on the original diskette and it will 
be thai way forever. 

I call my other bad experience with copy-protected software a "Phase 
of the Moon" problem. I have a copy- protected video game, Archon, 
that seems to consider the "Phase of the Moon" to determine if it 
should start the program. Usually, it takes several tries to start the 
program. 

I was worried that the disk might further deteriorate, and someday 
never start. Now, I have a backup and the wear and tear will be on the 
backup, not the original. 

tHow does Marauder work? Quite well - it works regardiess of the 
number of disk drives or how much memory you have. One warning - 
and [ HIGHLY recommend this - buy the additional 256K memory 
expansion. Without it, this program and most other programs will be 
severely limited. How limited is Marauder with 256K of memory? Well, 
you have to swap disks eighty times. Enough said. 

The program uses the Amiga interface. Intuition, and if you can pull 
down a menu and point and click, you should be able to use Marauder. 
As a matter of fact, I believe that you should be able to use the 
program without reading the manual ai all. 

The Marauder's startup screen carries a brief reminder of the laws 
governing software duplication. After clicking "OK" She program 
begins. The main program's screen is colorful and well-organized. It 
contains start and stop buttons for the copying process, and buttons 
to select the source and destination disks. 

In one corner is a chart with boxes for each of the eighty tracks on an 
Amiga disk. This chart also displays which side of the disk is being 
copied, and puts a checkmark in each box after that track has been 
copied. 



There are two menus. One displays the author's name and exits the 
program. The other menu contains the names of fifteen software 
titles. Selecting a name from this menu enters in the two codes 
necessary to backup the program. If you wish to backup a program 
that's not listed in this menu, you have to type in the hvo codes by 
hand. 

The program is packaged simply - just the disk, a sheet or two of 
instructions, and the disk itself, all bound with a piece of stiffening 
cardboard, and shrink-wrapped. Also included is a small pamphlet 
from ADAPSO, an organization which is dedicated to informing the 
public about legal and illegal software duplication. 

The manual is a concise, easy-to-read description of how to use the 
program. You will also learn how to copy programs that were released 
after Marauder's release. 

To copy newly released software, you can call Discovery Software, 
the makers of Marauder, and ask for the tivo codes necessary to 
backup newly released software. 

I called Discovery Software. I was pleased with their support. They 
were very courteous and pleasant. They asked for my registration 
number and promptly answered my questions. 

Unfortunately, Marauder has its flaws. One. it requires you (o reboot 
or reset the computer with Marauder as the Workbench disk to use it. 
This is just a pet peeve of mine but, 1 HATE programs that require you 
to reset the computer. 

On a multi-tasking computer if you have to reset the computer to start 
a program it CANNOT MULTI-TASK. Also, the Amiga has the ability to 
configure your computer to your liking with Preferences, but this 
configuration is lost when you reset. 

Another flaw is Marauder's inability to copy alt programs. I thought of 
a way to foil Marauder as soon as I used the program. A call to 
Discovery Software confirmed this method to foil Marauder. 
Discovery Software was already aware of this flaw and is working on 
an upgrade. 

{The two numbers necessary to copy a program define the track and 
sync for reading that track. Currently, Marauder can only accept one 
set of codes, so It can only copy disks that have only one funny, 
unreadable track like this. If a program is protected with hvo mis- 
synced tracks, the present version of Marauder will not copy the 
program.) 

This upgrade will be available to current Marauder owners for ten 
dollars. Luckily, no programs currently available use this method of 
copy-protection yet, so it is not a real limitation at this time. 

Overall, I have to give Marauder a hearty thumbs up and would recom- 
mend this product to friends. -AC' 
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The AMICUS Network 



by John Foust 

CompuServe [72337,135] 
People Link AMICUS 
Delphi JOHNFOUST 
UUCP through the Well "jfo"s'" 

Amiga public domain software is really starting to blossom. 
The llashiest examples are coming out of Commodore, from 
the technical support people, but Amiga owners are close 
behind. 

Printer drivers 

If you have a printer that doesn't have a printer driver in 
Preferences, you can always write your own. or have a 
programmer do it for you. Fortunately, I've been collecting 
printer drivers, so you might not have to write your own. 

We have a number of printer drivers available on disk 9, for 
the Canon PJ-1080A color ink jet printer, for graphics only, 
not text; the CItoh Prowriter; the Epson LQ-800; the Gemini 
Star-10; the Okidata ML92; the NEC 8025A; the Panasonic 
KX-P10XX family; and the Smith-Corona D300. 

The last three were written by Rick Wircli, the others were 

collected from the networks and other public domain 
sources. The Panasonic KX-P10xx driver is based on the 
Epson driver, but adds the ability to do subscripts and 
superscripts in letter-quality mode from programs like 
Textcraft. 

Also included is a new Epson driver, with the streak bug 
removed. When printing graphics, the oHicial Epson driver 
would overlap every eighth line of graphics, making streaks 
in the printed picture. This new driver doesn't have that 
problem. 

An electronic copy of the printer driver chapter from the 
developer's manuals is on Tech BBS disk, number 3. I have 
uploaded an ARChive file with this text and example printer 
driver source code to the CompuServe. People Link and 
Delphi networks. 

People Link Update 

In the last issue, I claimed People Link signup was free. It 
was, until May 20, when the price rose to $10. This price 
includes a free hour of time on the system. 

The People Link Amiga group is doing very well. The 
Amazing Computing and AMICUS section is becoming a 
good resource for programmers and novices alike. The data 
library is over thirteen megabytes. Lately, the Sunday night 
conferences have been consistently atlracting about 30 
people, and spontaneous conferences are happening every 
night of the week. 

We have not yet uploaded the complete contents of the 
AMICUS and Fred Fish public domain software disks. 



Summaries are available online for both colledions, in 
condensed form, similar to the catalogs presented here in 
the magazine. 

If you would like something uploaded to the network you visit 
most, please send me some electronic mail to one of the 
addresses above, and I will upload the software you 
request, as time permits. I feel most comfortable uploading 
to Compuser^^e, Delphi and People Link. 

I'm still trying to break through the menus on the Well, and 
get to the Unix underneath, and with the moderation on 
Usenet, and the hassles oi 'uucp', I'd rather establish a 
direct Snail Mail link with the moderators in charge of this 
sort of distribution. 

Please don't think we've sold our soul to People Link. Many 
of the authors here at Amazing Computing are active on 
several networks, myself included. 

Updated AMICUS disks 

The appearance oi new Workbench techniques, compilers, 
and updated programs poses a question for the distributors 
of public domain software disks. Do you replace the old 
software, or add the new to a newer disk? 

In most cases for the AMICUS disks. I have chosen to 
improve the old disks, and replace buggy versions in place, 
instead of freezing the old disks, and adding the new 
software to the most recently assembled disk. 

Some people have the original disks I distributed in the fall of 
1985. People who get the AMICUS disks today will be 
getting the best disk we can make. They won't have lo worry 
about checking Ihe whole catalog of software to find newer 
versions of a particular program. 

For example, when we created a method of launching ABasic 
programs from an icon on the Workbench, we added this to 
AMICUS disks 1 and 2. Some people won't have the 
improved disks, but everyone who gets them in the future will 
get a better product. 

Also, the Manx C compiler can halve the size of many 
compiled programs, so this has made more free space on the 
disks, too, to allow for more enhancements. like the ABasic 
Workbench launcher. 

Dlsk9 

The Amiga Basic programs on disk nine include FlightSim, a 
simple flight simulator program; HuePalette, the hue- 
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saturation-intensity program by Steve Pietrowicz from the 
article in Amazing Computing; Requester, a requester 
subroutine for use in your programs; ScrollDemo, a 
demonstration of the text scrolling capabilities of Amiga 
Basic, Synthesizer, a sound program; and WorldMap, a 
program that draws a map of the world. 

The executable programs include the newest version of the 
Boing! demo, which lets you adjust the speed of the 
bouncing ball. 

Disk 9 has the Wombat terminal program, as announced in 
the last issue. 

The program Brush2C converts an IFF brush file, as saved 
from Deluxe Paint, to C structure declarations. This program 
was called 'image' in the last issue of Amazing Computing. 

Another similar tool, Brush2lcon, converts an IFF brush to a 
Workbench icon. 

Dazzle is a graphics demo program that makes very 
interesting patterns, based on mouse movements. 

This disk has full instructions for installing a 68010 chip in 
place of your 68000 chip. This will give an overall increase in 
speed of about 10 to 15 percent. This text may be printed in 
a future issue of Amazing Computing. Accompanying this 
text, DeciGEL is a program to patch the exception vectors 
on the 68000 Amiga to allow unrestricted use of a 68010 
chip. The assembly language source for DeciGEL is 
included, by Scott Turner. This irons out the few differences 
between the two chips, and prevents crashes from software 
that bends the rules of the Amiga operating system. 

Klock is a variation on the clock-on-the-window-bar theme. 
This small time display alternate between the current time 
and date every few seconds. 

TimeSet is a gadget-oriented method of setting the time on 
the Amiga. Instead of using Preferences or the CLl 'DATE' 
command, you just move a few gadgets in TimeSet, and the 
system dock is updated. 

Disk 9 has a version of the game of Life. This game is 
always exciting to me. 1 have played the version in the 
Gizmos utility set for hours on end. 

This disk contains yet another version of MicroEmacs, a 
version twiddled by Rick Wirch, based on the version by 
Andy Poggio from the Fred Fish disks. Wirch added drop- 
down menus for many functions, and added word-wrap, 
paragraph formatting, and sellable margins. With these 
additions, this version of fviicroEmacs becomes usable as a 
word processor. The full source code in C is included. 

Also present is tVlyCLl version 2.00, a shell that replaces 
many CLI functions, and adds several more. It has the 
advantage of taking less RAM space than keeping all those 
commands in the RAM: disk, while giving extra features like 
command line editing, so you can correct your typing 
mistakes, and search paths for commands. Also, this 
program might be the subject of a future article in Amazing 
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TERM . Full ANSI terminal emulation with re-sizable ai^d full screen window 
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The texts on disk 9 demonstrate how to read the function 
keys in Amiga Basic, a solution to the game of Hacker, tips 
on printer usage and startup-sequences, and a list of things 
that work or don't work under the Transformer, 

Disk 10 

Disk 10 is a compilation of the best sampled sounds from the 
several 'instruments' dealer demos that circulate. The demo 
is icon-clickable. Among the sounds on the disk: acoustic 
guitar, alarm clock, banjo, bass guitar, boink, calliope, car 
horn, claves, drip, electric guitar, flute, harp arpeggio, 
kickdrum, marimba, organ minor chord, people talking, pigs, 
pipe organ, Rhodes electric piano, saxophone, sitar, snare, 
steel drum, bells, vibes, violin, wail guitar, a horse whinny, 
and a whistle. 

What will be coming upon disk 1 1 ? Disks 11 through 13 are 
stil! being organized and filled, but in the issue, they will be 
fully described. 

Disk 11 will have a charming program from Commodore that 
looks like a strip chart recorder. It plots CPU and memory 
use over time. Along with that comes a program to list all the 
tasks running in memory. Also, it allows you to adjust the 
priority of each. 

These won't fill the disk, so there will be other software here, 
too. One will be a very cule calendar program written in 
Amiga Basic, with a built-in animated diary. 

Disk 12 is a bulletin board program written in Amiga Basic, by 
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Ewan Grantham. Grantham lives outside Atlanta, and 
hosted an Amiga hacker parly during COMDEX. 

Disk 13 has several programs by Carolyn Scheppner o) 
Commodore technical support in West Chester. All are in 
Amiga Basic. This disk features programs documenting a 
new IFF hunk type that eases the loading and saving of IFF 
images under Amiga Basic. These programs demonstrate 
the use of many different libraries to access AmigaDOS 
functions, as several articles in recent issues of Amazing 
Computing have shown. 

I'm very glad to present this, since so many people 
have asked for this capability. These programs will be 
featured in the next issue of Amazing Computing. 

Because this has such appeal, I'm working on articles to 
complement Scheppner's programs. I hope to document the 
process of writing your own AmigaDOS libraries, and present 
a full explanation of '.fd' files and '.bmap' files. 

Disk 13 isn't filled by these programs, so there will be other 
programs added to it soon. I have a set of examples from 
the 1.1 ROM Kernel Manual. 

Fred Fish disks 

Fred Fish has been busy, too. His collection has grown to 24 
disks, and he has already mentioned some features of future 
disks • including public domain C compiler. 

Because of the length of the additions to the Fred Fish 
collection, please read the catalog prss finted in nur nftxt 



issue. I'll cover a few highlights in the new disks 1 2-24. 

Disk 14 has the full C source to a generalized 3-D graphics 
package, with hidden surface removal. This could go a long 
way in the right hands. This was used to write the rotating 
Amiga sign found on many dealer demo disks. It realiy shows 
thepowerof the Amiga when a great demo can be written in a 
generic, extensible graphics package. 

Disk 16 is a copy of the latest IFF disk specifications from 
Commodore. 

Disk 18 has a program that will speak Pig Latin, if you are 
getting tired of the SAY command. It also has the source 
and executable for Xlisp 1.6, a public domain Lisp interpreter 
I've been promising you for a long time. 

Disk 19 has a set of hi-res IFF pictures drawn by Jay Miner, 
the designer of the Amiga graphics chips. These pictures 
are flowcharts of the internals of the Amiga and its chips. 

Disk 20 has a sample port-handler, in disassembled 68000 
code, by John Toebes. This caused some consternation at 
Commodore-Amiga when he posted this to Usenet. 

They thought he had stumbled upon some of their source 
code, since some of the labels were the same as the original 
code. I saw Toebes at COMDEX, getting chased around the 
booth by a Los Gatos techie. His alibi? It turns out the 
labels were printed in an obscure listing in the ROM Kernel 
Manual. 

Disk 20 has an example showing the hashing algorithm used 
on Amiga diskettes, and a tutorial on multitasking, by John 
Draper. Also included are the winners of a Mandelbrot 
picture contest, and a demo version of TxED, an editor from 
MicroSmiths. 

Disk 21 is devoted to Thomas Wilcox's Mandelbrot Set 
Explorer. This is an extensive Mandelbrot set program, with 
features beyond the other Mandelbrot 
programs around. 

If you haven't heard of the Mandelbrot set, or seen 
Mandelbrot pictures, here's a simple explanation. The 
Mandelbrot set is a complex mathematic object that yields 
fascinating color graphics pictures. Since it takes a lot of 
computation to make each picture, this disk represents 
dozens of hours of computing. 

Disk 24 has a pre-release public domain Modula-2 compiler, 
direct from Prof. Wirth's grad students. Currently, the 
programs are executed with a special binary loader, so it 
does not produce standalone code yet. 



IBM PC software 

In the next few issues of Amazing Computing, we'll be 
covering some new public domain software, for both the 
Amiga and the IBM PC. With the advent of the Sidecar, we'll 
also be assembling a "best of" collection of public domain 
software for the PC compatible machines. 
_ -AC ' I 
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Building Tools By Daniel p. Kary ^ 



My good friend Lew likes to build tools. The kinds of Jools he 
builds are never available in stores, that is why he builds 
them. The reason his tools don not exist in stores is that 
they are designed for a specific task rather than for general 
use. 

I can not begin to count the hours I've spent in Lew's garage, 
or the number of times he has decided to build a new tool 
before we start the actual project. So many times I have 
been surprised that the new tool saved us much more time 
than it took to build. 

I guess I've known Lew for about sight years now, and his 
attitudes must be beginning to influence me. Last weekend I 
built a tool for my Amiga that will probably never be available 
in a store, but it has already proven so useful to me that I 
would not want to be without it. I want to tell you about my 
tool and suggest that you might be able to build some useful 
tools for yourself, 

I am working on a large program for the Amiga that will 
probably make me rich and famous. I am writing this program 
in Lattice C. I have not programmed for a window-oriented 
environment before. 

Programming the Intuition environment is challenging. 
Intuition is very flexible, and that is the root of the problem. 
It is nice that I can create a menu strip, with the menu items 
positioned precisely where I want them, but the price is high. 

I have to specify where everything goes, even when I do not 
particularly care. Menus are specified by creating and 
initializing a data structure, and then passing the address of 
that structure to an Intuition function. 

This same technique is used for everything from the screen 
and its windows to gadgets and requesters. Certainly, it is a 
flexible technique, but there are so many different structures 
that I have difficulty dealing with them. I can not remember 
what the elements are, their types or their names and I need 
to know each of these at some time or another. 

My Intuition manual is beginning to take on a distinctively 
tattered look from all the times I have leafed through it to find 
the definition of a structure. The yellow "Post-It" notes that I 
use to mark my favorite pages are lorn and curled. 3M could 
save me some effort if they sold pretattered "Post-It" notes. 

1 reached a point where I could not stand it anymore. I had to 
do something about this. "How about a programmers 
reference card", I wondered. No. There are too many 
structures for a programmers reference card, it would end up 
becoming another manual to leaf through. 

How about a Rolodex? An Intuition Window structure alone 
would take about eight cards. Besides, my desk is starting 
to feel cramped as it is. 



"I wish I could just press a button and have the structure pop 
up on my screen", 1 thought. "Oh, well. Paging through the 
manual isn't that bad". 

I admit it, I am slow, but it did finally come to me. Why can't I 
just press a button and have a structure pop up? 

Pop-up information is a big seller on single-tasking 
computers. It should be a breeze to get the same thing on 
my multitasking Amiga. It was all over but the shouting {and 
the coding). 

My plan was to write a program that could display the data 
structures. I could start this program from the CLI and use 
the front-back gadgets to pop it to the front whenever I 
wanted it. 1 decided to set up a data file first. My program 
would read the structures out of the data file. 

Now, how should I create that file? The structures are all in 
the manual, I could just type them in. That was a pleasant 
thought. Thinking further it occurred to me that I had a 
magnetic copy of all the structures since they are all defined 
in the include files. I could just edit those files. Another 
pleasantthought. 

Finally, what if I wrote a small program to copy the structures 
out of the include files. Why can't I ever think of the easy 
way first? See Listing 1 , the module 'select.c' 

Things became a little complicated at this point. I was using 
the new V1.1 Amiga C compiler, which is Lattice C V3.03. 
The include files supplied with this version have the 
comments stripped out. Neato. 

Back to Amiga VI. 0, or Lattice C V3.02. Later, I'll discuss 
differences between the include files of the two versions. 
For now, I'll just consider the problem of getting the 
structures out of the include files. 

Since every structure definition begins with the reserved 
word 'struct,' it is not too challenging to find the structure 
definitions in the include file. 

Because I have some experience in writing compilers, 1 knew 
that the problem is not as simple as finding every instance of 
the reserved word 'struct'. That word could occur in a 
comment, in a string literal or in the definition of an object or 
a pointer of a struct type. 

To handle the problem correctly I really should have written a 
parser so 1 could correctly determine when a structure 
definition occurred. This would not be difficult using modern 
parser construction techniques, but this is more work than 
simply editing the include files, the work I was trying to 
avoid. 

After scanning through the listing of the include files in the 
back of the ROM Kernal Manual, 1 found I could recognize all 
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the structures with two simple tests. The reserved word 
'struct' occurs in column 1 and there is an open bracket '{' on 
the same line as the word struct or the line following it. The 
end of the structure definition is marked with a closed 
bracket, '}'. 

Some structures have unions as members. Unions are 
delimited with open and closed brackets. By maintaining a 
bracket count, the end of a structure Is found when the 
number of closed brackets scanned is equal to the number 
of open brackets scanned. 

The function 'readJileO' in 'select.c* uses this simple 
technique to extract structure definitions from the file and 
works for most of the structures defined In the include files. 

The struct 'Library' defined in <exec/libraries.h> is declared 
"extern", I decided to simply break this line after the word 
"extern". This does not change the meaning of the 
declaration. This is simpler than modifying the code to deal 
with this aberration. 

Another problem is the struct 'Bob' in <graphics/gels.h>. 
The declaration is followed by a comment rather than the 
open bracket. I pined the comment line to the previous line. 

Finally, all structure declarations in <devices/parallel.h> and 
<devices/serial.h> are preceded by a blank. I deleted this 
blank. 

There are two new files and a new structure in an existing file 
of Amiga V1 .1 (Lattice V3.03) that were not present in Amiga 



V1.0 (Lattice V3.02). 

The new files are <[attice/setjump.h> and 
<devices/prtbase.h>. The file <exec/ports.h> contains the 
new struct Semaphore. Four structs were deleted from 
<devices/clipboard.h> in Amiga VI. 1, they are 'ClipStream, 
'Clipltem,' 'ClipANSr and "ClipBitMap.' 

After I debugged the "read_file()' function, I decided it would 
be convenient if 'select.c' would search directories 
recursively. 

That way I could just specify the include directory and 
select.c would extract all the struct definitions from all the 
files in that hierarchy. I then wrote the function 'search()' to 
recursively search whatever name it is passed for files. 

I considered this an interesting diversion, I had been looking 
for a good reason to recursively search directories just to 
see what was involved in doing it under AmigaDos. It turned 
out to be an easy task. 

Simply 'LockO' the file then 'ExamineO' it to determine if it is 
a file or a directory. If it is a directory, pass it (recursively) to 
'searchO." othen/vise pass it to 'read_file().' 

The 'searchO' function can be used in any program where a 
recursive descent of a file hierarchy is desired. For this, 
change the name of the function that is called when a file 
name is found. 

The final version of 'select.c' reads two arguments from the 
command line. The first argument is the file or directory to 
search and the secxsnd is the name of the file to use (or the 
output. 

You may not have noticed, but my original intention was to 
create a tool to spare me the pain of paging through my 
Intuition manual. On the way I created a tool to build the 
data file that my tool would use. 

This reminds me of potato chips or salted peanuts - 1 can't 
eat just one. In the end, I probably spent as much time 
writing 'select.c' as 1 would have spent editing the include 
files to extract the structures. 

But I now have a nice little program that I can share more 
easily than I could share the data file it creates. Space in 
magazines is scarce and time on a bulletin board or network 
can be expensive. Furthermore, the include files are a 
copyright of Commodore-Amiga, and t don not have 
permission to distribute even partial copies of them. 



The program that displays 
'display.c,', in Listing 2. 



the structures is called 



'Display.c' is very simple. It allocates resources using the 
technique suggested by Perry Kivolowitz in the premiere 
issue of Amazing Computing. 

It reads in the data file(s), which are specified as command 
line arguments, and then builds the menu strip. Finally, it 
enters a "while' loop that wails for mouse events and 
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displays the requested structures. 

The function 'read_file()' reads the data file(s) and builds a 
structure to hold all the data. The data file marks the 
beginning oj each new item with a line that begins with '!'. 
This means that 'display. c' is not limited to displaying 
structures. Any type of textual da(a can be displayed. 

Just create a file with the data and mark the beginning of 
each item with an '!'. The text that follows the '!' will be used 
as the menu label for that item. The end of an item is marked 
by either the beginning of the next item or the end of the file. 
When a complete item has been read in it is inserted into the 
list of items in alphabetical order. 

When all data files have been read in, 'build_menu()' splits 
the list of items into fourteen sublists. Each sublist 
becomes a set of menu items under a menu strip item. The 
maximum number of fourteen sublists was selected because 
it is the largest number of items that 1 felt could fit 
comfortably on the menu strip. 

Each of these fourteen items can have up to eighteen menu 
items, the most I could comfortably fit on the screen. This 
yields a total maximum of 252 items thai can be displayed. 
The titles on the menu strip consist of the first three 
characters of the first menu item under that title. 

These mnemonics are similar lo the labels found on the spine 
of many encyclopedias, they are used to locate the volume 
that contains the information you are looking for. 

When a structure is selected from the menu it is displayed on 
the screen by the function 'redisplayQ'. Since the screen 
has to be brought to the foreground with the mouse by 
clicking the depth arranging gadget, and the item is selected 
from the menu with the mouse, I wanted the entire display to 
be controllable from the mouse. 

Some structures fit on the screen but others are quite long 
and scroll off the screen. The display can be paused by 
holding down the menu button of the mouse {the right 
button}. I did not write any code to accomplish this, it is a 
side effect of the fact that Intuition causes al! screen I/O to 
pause while the menu system is active. 

The display of an item that is longer than the screen can be 
halted by pressing the select button of the mouse (the left 
button). When the menu button is used to pause the display, 
it must be released before the select button can be pressed 
to stop the display. Any mouse events that occur while the 
menu button is pressed are assumed to be directed to the 
menu system. 

If an item is being displayed at full speed, it requires 
considerable dexterity to release the mouse button and 
press the select button before information scrolls off the top 
of the screen. I felt it was necessary to slow down the 
display speed to avoid the need for such uncommon 
dexterity. 

It seemed a shame to slow down the printing of short items, 
so I compromised. The first sixteen lines of text are 
displayed at full speed, a delay is introduced after displaying 
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#include <libraries/dos.fi> 
tfincluda <stdio.h> 


/^ 
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main(argc, argv) 
int argc; 
cfiar *argv[]; 

{ 
inti; 
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if(argc<3)( 
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exit(1); 
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argc--; 

if((fout =fop8n(argv[argc], "w")) == NULL){ 
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prinlf ("Unable to write to %s\n", argv[argc]); 
exit(1); 
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searcfi{name) 
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cfiar 'name; 

r recursively search "name" for files V 

{ 








each subsequent line. This time delay can be changed by 


modifying the parameter in the call to 'DelayO' near the end 


struct FilslnfoBlock *FIB, *AllocMemO; 


of the function 'redisplayO'. The truly fleet of finger may 


int lock; 


delete this line all together. 


chiar'subdir; 


The display program and the data for all the structures 


if((FIB= AllocMem(sizeof(stf uct FilelnfoBlock),0))==0){ 


defined in all the include files requires about 100 Kbytes of 


prinlf ("Can not allocate memory for FIB\n"); 


RAM. It is hard to spare this kind of RAfVl in an Amiga with 


return(O); 


less than a megabyte of RAM. 


} 




if((lock = Lock(name, SHARED_LOCK)) == 0){ 


There is little chance that anyone will actually need ALL the 


printf{"Can not Lock %s\n", name); 


structures available at a time. One way to proceed would be 


FreeMem(FIB, si2eo!(struct FilelnfoBlock}}; 


to use select to create several data files and read in only the 


return(O); 


ones you are currently using. 


} 




if{( Examine (lock, FIB)) == 0)( 


The display program could be extended in several ways. The 


printf("Can not Examine %s\n", name); 


most obvious would be to include a way to read in new data 


UnLock(lock); 


files. A way to expunge menu items, free the memory they 


FreefVlem(FIB, sizeof(struct FilelnfoBlock)); 


occupied and rebuild the menu strip would also be nice. 


return(O); 


A user who can not spare any RAM could modify the display 


) 

if(FIB->fib_DirEntryType > 0){ 


program to keep only a data file offset in RAM and then 


printf("%s (dir)\n", name); 


'seekO' to this position in the file to find the data to display. 1 


wfiile(ExNext{lock, FiB)){ 


personally would rather use the RAM and avoid waiting for 


subdir= (char ') malloc(stflen(name)-i- 


the floppy disk. 


s1rlen(&FIB->fib_FileName[0])+2); 




s1rcpy(subdir, name); 


1 showed my new tool to my good friend Lew. He liked it, but 


if(not_device(name)) 


is not going to use it yet. He is still trying to sell the eight- 


strcat(subdir, T); 


bitter he bought back in '78. Once he dumps his old 


strcat(subdir,&FIB->fib_FileName[0]); 


machine, he plans to get an Amiga. Lew has understood the 


if (FIB->fib_DifEntfyType > 0) 


value of good tools for some time now. 'AC* 


seafch(subdif); 
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else{ 
printf("%s\n", subdir}; 
reacljile(subdir); 

} 
free(subdir); 

} 
} 
els@{ 

printf("%s\n", name); 
read_file{narne); 

) 

UnLock(lock); 

FreeMem(FIB, sizeof(struct FilelnfoBlock)); 



} 



not_device(name) 

char name []; 

/* return TRUE if the last char is not a colon */ 

( 
intij; 

for(i = 0; namep]; i++){ 
if(name[i] ==':'} 

j = FALSE; 
else 
j = TRUE; 
} 



return{j); 



} 



read_file(name) 

char *name; 

r find all the struct definitions in the named file 

* and write them on the users output file 

7 

{ 
FILE *fin; 

char buf1[256], buf2[256], buf3[256]; 
int Foundl , Found2, count, q, i, j; 

if((fin = fopen(name, V)) == NULL){ 
printf("Unable to read %s\n", name); 
return{0); 



} 



whfle((fgets(&buf 1 [0], 256, fin)) != NULL){ 
if(stfncmp(&buf1[0], "struct", 6) == 0){ 
Foundl = Found2 = FALSE; 

if(stcpm(&buf1[0], "{''.&q)){ 
count = 1; 
Foundl s^TRUE; 

} 

else( 
if((fgets(&buf2[0], 256, fin)) U NULL){ 
if{stcpm(&buf2[0], "{". &q)){ 
count = 1; 
Found2 = TRUE; 



} 

if(Found1 II Found2)( 

for(i = 6; !isalpha{buf1[i]); i++}; 

for(j = 0; isa!pha(buJ1[i]); i++, j++) 
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♦include SI. 00 for shipping and handling 
AMIGA is a trademark of Commodore Business Machines 



} 



buf30] = buf1[i]; 
buf30] = W; 

fprintf{fou1,"!%s\n", &buf3[0]); 
fprintf(fout,"%s\n", name); 
fprintf(fout,"%s",&buf1[0]); 

} 
if(Found2) 

fprin1f(fout,"%s",&buf2[0]); 
while{Found1 || Found2){ 
if ((fge1s(&buf 1 [0], 256, fin)) != NULL) 

fprintf(fout,"%s",&buf 1 [0]); 
else{ 
fclose(fin); 
return (0); 

} 

if(stcpm(&buf1[0],"{", &q)) 

count++; 
if(stcpm(&buf1[0]. "}", &q)) 
if(--count==0) 
Foundl =Found2 = FALSE; 
} 
} 
} 
fclose(fin); 
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DISPU\Y.C Copyright Daniel D. Kary 1986 

Standard Listing 
*l 

#include <exectypes.h> 
#include <execAasks.h> 
#include <exec/1ibraries.h> 
#include <exec/devices.h> 
#include <graphics/copper.h> 
#include <graphics/display.h> 
#include <graphics/text.h> 
#include <graphics/view.h> 
#include <graphics/gels.h> 
#include <graphics/regions.h> 
#inciude <hardware/blit.h> 
#include <intuition/intuition.h> 
#include<intuition/intuitionbase.h> 
#include<s1dio.h> 
Sinclude <libraries/dos.h> 
#inc!ude <workbench/workbench.h> 

/* Resource Flag definitions '/ 
#defineFJNTUITION 0x000001 
#defineF_GRAPHICS 0x000002 
#define F_WRITE_PORT 0x000004 
#define F_WR!TE_MSG 0x000008 
#define F_WINDOW 0x000010 
#define F_CONSOLE 0x000020 

r Menu definitions */ 
Sdefine MENU_PROJECT 
#define ITEM_HEIGHT 10 

r for the PROJECT Menu ... '/ 
#define PROJECT_TOP 
#define PROJECT_BOTTOM 1 
#define PROJECT_UP 2 
#define PROJECT_DOWN 3 
#define PROJECT_WIDTH 120 
#define PROJECT BAR 75 



/* for ttie DATA Menu's 
#define DATA_BAR 
#define DATA_;WIDTH 
#defineDATA LEFT 



40 
95 

(-60) 
14 



#define MAXHEADINGS 

#define MAXLINES 18 

#define MAXITEMS (MAXHEADINGS ' MAXLINES) 

struct Text { 

r linked list of lines of text V 
struct Text *next; 
char *line; 

}; 

struct X_Menul!em { 

r expanded Menuitem, Includes a pointer to user data*/ 

struct X_Menullem 'Nextltem; 

SHORT LeftEdge, TopEdge; 

SHORT Width, Height; 

USHORT Flags; 

LONG MutEx; 

APTR ItemFill; 



APTR SFill; 
BYTE Command; 
struct Menuitem "Subltem; 
USHORT Select; 
struct Text "text; 



}; 



struct IntuiText ProjectText = 

{ 
0, 1.JAMI, r front, back, mode */ 

1,1, /* left, top 7 

NULL, r font 7 

-RE-DISPLAY", 

NULL, rnextV 



struct Menuitem Project = 

{ 
NULL, /'next 7 

0, ITEM_HEIGHT * 0, r select box left, top 7 
PROJECT_WIDTH, r select box width 7 
ITEM_HE1GHT, r select box height 7 

ITEMTEXT I COMMSEQ | ITEMENABLED | HIGHCOMP, 

r flags 7 
0, r mutual exclude*/ 

(APTR)&ProjectText, r text 7 
NULL, r select image */ 

'R', r command */ 

NULL, /*subitem7 

NULL, /• next select 7 



struct Menu MainMenu = 

{ 

NULL, r next menu V 

5,0, r select left, top 7 

75, 10, /* select width, height 7 

MENUENABLED, T flags 7 

"Project", next 7 

&Project, /"first item 7 

0, 0, 0, 0, r mystery variables */ 

}; 

struct NewWindow nw = 

( 

0,0, r left, top */ 

640,200, r width, height 7 

-1,-1, r detail pen, block pen */ 

CLOSEWINDOW | MOUSEBUTTONS | MENUPICK, 

/* IDCMP Flags ■/ 
WINDOWDEPTH | WINDOWSIZING | WINDOWDRAG | 
ACTIVATE I SMART_REFRESH I WINDOWCLOSE, 

r gadget fiags*/ 
NULL, r user gadgets 7 

NULL, /'user check 7 

"Structure Display", /* title */ 
NULL, r screen */ 

NULL, /* super bitmap*/ 

100,45, r min width, min height*/ 

640,200, r max width, max height 7 

WBENCHSCREEN /" screen type */ 

}; 
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struct X_Menultem X_MenuTemplate = 

{ 
NULL, /'next 7 

DATA_LEFT, 0, /* left, top V 

DATA_WIDTH, ITEM_HEIGHT,/* width, height */ 
ITEMTEXT I ITEMENABLED | HIGHCOMP, 

/' flags '/ 
0, NULL, NULL, T f^utEx, Fills V 
", NULL, /* Command, subitem V 

NULL, NULL /* Next, Text List V 



struct Menu MenuTemplate = 

{ 
NULL, /*next*/ 

0,0, /'left, top 7 

DATA_BAR, ITEM_HEIGHT. /* width, height V 

f\AENUENABLED, T flags 7 

NULL, NULL, /' text, first item 7 

0,0,0,0 /* mystery vafiables 7 



}; 



extern struct lOStdReq *CfeateStdlO(); 
extern struct MsgPort *CreatePon(); 

struct Window 'w; 

struct IntuiMessage 'message; 

struct iOStdReq 'WriteMsg; 

struct MsgPort 'WritePort; 

struct Text 'currentjext = NULL; 

struct X_Menuitem 'head = NULL; 

struct X_Menu[tem 'temp = NULL; 



struct Text 'first = NULL; 
struct Text 't = NULL; 
int Items = 0; 
ULONG Gf xBase; 
ULONG IntuitionBase; 
int cur resource = NULL; 



main(argc, argv) 
int argc; 
char *argv[]; 



{ 



int i, class, code; 
struct X_Menultem*p; 

if(argc < 2){ 
printf ("USAGE; %sfile(s)\n", argv[0]); 
exit(1); 

} 

if((GfxBase = OpenLibrary("graphics.llbrary",0)) == NULL) 

abortfCan't open graphics.library"); 
cur resource |=F GRAPHICS; 



if((lntuitionBase = 
OpenLibraryC'intuition. library", 0))== 
abortfCan't open intuition.library"); 

cur_resource |= FJNTUITION; 



NULL) 



if((WritePort = CreatePor1("con.write",0)) == 0) 

abort("Can't create console write port"); 
cur resource l=F WRITE PORT; 



Conversation With A Computer 

(It's a lot of fun, a brain teaser and a programming guide too!) 

"Very highly recommended by me is Conversation With A Computer, from Jenday Software, a set 
of games and conversation written in Amiga Basic, and shipped with the source code provided. It is 
entertaining, amusing, thought provoking, and just plain fun. If you have any interest in programming 
in BASIC on the Amiga, this is a must have for the examples." 

-MATTHEW LEEDS, Commodore Microcomputers 

This program really shows off Amiga's talents: lots of color graphics, mouse routines, voice synthesis, sound 
and animation. The 2,000 lines of Amiga Basic can be listed to screen or printer. The documentation describes 
in detail, module by module, how it all works. There is a coded example of virtually every one of Amiga Basic's j^ 
powerful features, 

Youll be challenged to three mind games, Memory Test will drive you to drink. Battle of Numbers 
and Pegboard are two of the most elegant logic games of all time. It's your brain against Amiga's silicon. 

The program is professionally packaged with comprehensive tjpeset documentation. It requires 
512K. It is not copy protected. Now includes an introduction to the C language. 

JEMPAY 

SOFTWARE 

P.O. Box 4313 

Garden Grove, CA 92642 



All orders are shipped by first class 
mail within 24 hours of receiving 
your personal check or money 
order. 



DEALER INQUIRIES INVITED 

(714) 636-3378 
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Amiga Project 

Programming Journal for the Amiga 



A no-nonsense journal dedicated to 
programming for the Amiga, on the Amiga. 
Monthly columns written by experts 
covering Forth, C, assembly, Modula-2, 
Pascal, and more. 

Help and advice for those of you who want 
to REALLY program your Amiga. 
No HYPE, No Gee-WizHH 

$24.00 for 12 informative issues.... 
Send your check or money order to 

Amiga Project 

P.O.Box 285 

Kent, OH. 44240 
216-673-0185 

Dealers, Advertisers, Call for current pricing info... 



if((Wr!teMsg = CrealeStdlO(WritePort)) == 0) 
abor)("Can't create console write message") 
cur_resource |= F_WRITE_MSG; 

if{(w = (struct Window *) OpenWindow(&nw}) : 

abort("Can't open new window"}; 
cur_resource |= F_W]NDOW; 



NULL) 



WriteMsg->io_Data = (APTR) w; 
WriteMsg->io_Length =sizeof(*w); 
i{((OpenDevice{"console.device", 0, WriteMsg, 0)) != 0) 

abort("Can't open console") ; 
cur_resource |= F_CONS0LE; 

Pu!Str(WriteMsg,"\033[0 p"); T turn the cursoroff 7 
PutStr{WriteMsg, "Reading Data File(s), Please Wait.\n" 
ior(i = 1 ; i < argc; i++) 

read_file(argv[i]); 
build_menu(); 

PutChar(WriteMsg. OxOc); /* clear the screen V 
SetMenuStrip(w, AMainMenu); 



while(l)( 
Wait(-I); 

while{message = (struct intuiMessage ') 
GetMsg(w->UserPort)){ 
class = message->Class; 
code = message->Code; 
Reply Msg(message); 
if(class == CLOSEWINDOW)( 
abortC'Bye!"); 

} 

if(class»=.MENUPICK){ 
switch MENUNUM(code){ 
case NOMENU: 

break; 
case MENU_PROJECT: 
redisplayO; 
break; 
default: 
p = (struct X_Menultem *) 

ltemAddress(&MainMenu, code); 
current_text = p->text; 
redisplayO; 
break; 



} 



} 



} 



abort(s) 
char's; 

{ 
if (cur_resoufce & F_CONSOLE) 

CloseDevice(WriteMsg); 
if (cur_resource & F_WINDOW){ 
CleafMenuStrip(w); 
CloseWindow(w); 

} 

if (cur_resource & F_WRITE_MSG) 

DeleteStdlO(WriteMsg); 
if (cur_resource & F_WR1TE_P0RT) 

DeletePort(WritePon); 
if (cur_resource & F_GRAPHICS) 

CloseLibrary(GfxBase); 
if (cur_resource & F_INTUITION) 

CloseLibrary(lntuitionBase); 
printf("%s\n",s); 
exit(O); 
} 

redisplayO 

{ 
inti, class, code; 
struct Text *t; 

i = 0; 

t = current_text; 
PutChar(WrileMsg, OxOc); 
while(t){ 
if(message = (struct IntuiMessage * 
GetMsg{w->UserPort)){ 
class = message->Class; 
code = message->Code; 



/* clear the screen 7 
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} 



RepIyMsg(message); 
if(class == MOUSEBUTTONS) 
if(code == SELECTDOWN) 
return(O); 

} 

PutStr(WriteMsg, t->line); 

1 = 1->next; 

if(i++>16)Delay{3); 



} 



read_file(s) 
char's; 

{ 
FILE'fp; 
charbuf[256]; 
struct lntuiText*it; 

if((fp = fopen(s, r))==NULL)( 
spfintf(&buf[0],"Unabte to read %s\n", s); 
PutStr(Wri1eMsg, &buf[0]); 
Delay(120}; 
return(O); 

} 

while{(fge1s(Scbu(|0], 256, fp)) != NULL){ 
if(buf[0] == T){ 
buf[(strlen(&buf[0])-1)] = \0'; 
if(ltems == MAXITEMS){ 
sprintf(&buf[0], 

"MAXITEMS exceeded in %s\r\n", s); 
PutStr(WriteMsg, &buf[0]); 
1close(fp}; 
Delay(120); 
return(O); 

) 

ltems++; 

temp = (struct X_Mefiultem *) 

myalloc(sizeof(struct X_MenuItem)); 
'temp = X_MenuTemp!ate; 
1emp->ltemFill = (APTR) 

myalloc{sizeof{struct IntuiText)); 
it = (struct IntuiTexl ') temp->ltemFili; 
"it = ProjectText; 

ft->IText = (UBYTE ') myalloc(1 2); 
lirst = NULL; 

strncpy(it->IText, &bu([1], 11); 
insert(temp); 

} 

else if(temp){ 
t = (struct Text ') myalloc(sizeof (struct Text)); 
t->line = (char') myalloc{s1rlen(&buf[0])+1); 
strcpy(t->line, &buf[0]); 
t->next = NULL; 
if(first) 

first->next = t; 
else 

temp->texl = t; 
first = t; 
} 
} 

fclose(fp); 
temp =NULL; 
first = NULL; 



ADFO 

AMIGA DISK FILE ORGANIZER 

Having trouble finding that file somewhere in 
your stack of floppys? Can't find all the copies 
of a particular file? 

ADFO maintains a database of the directories 
disknames and filenames from your collection 
of disks. Fast response inquiries return loca- 
tion and last update information. Printer inter- 
face. Uses CLI or Workbench. 

51 2K ram and 2 drives recommended— $59.95 

Include S3.50 S & H 

Mastercard /Visa Accepted 

Sorry, No COD 

Calif, Residents Add 61/2% Sales Tax 

3386 Floyd 

Los Angeles, CA 90068 

(213) 851-4868 

0;der phone 1 800 621-0849 ExI. 494 



build_menu{) 

{ 
int i, j, headings, items; 
struct Menu *m; 
struct IntuiText *t; 

if(ltems<=MAXHEADINGS){ 
headings = (tems; 
items = 1 ; 

) 

else{ 
headings = MAXHEADINGS; 
items = Items/(MAXHEAD1NGS - 1 ); 
} 

m = &MainMenu; 
for(i = 0; i < headings; i++){ 
if(head){ 
m->NextMenu = (struct Menu ") 

myalloc(sizeof(struct f^^enu)); 
m = m->Nex1fvl9nu; 
*m = MenuTemplate; 

m->LeftEdge = PROJECT_BAR + (DATA_BAR * i) 
m->fv1enuName = (BYTE *) myalloc(4); 
m->Firstllem = (struct Menultem *) head; 
t = (struct IntuiText ') head->ltemFill; 
strncpy(m->MenuName, t->IText, 3); 
} 
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:^ 


AMIGA 
2S6K CARD 

Only $ 99.00 

1 VEAR 
WARRANTY 

AAUOi GIV!S «X) A CREATIVE EDGE. 

-C^ MICHIGAN SOFTWARE 
[J DISTRIBUTORS INC. 

tilAi CHANO HIVER • HOVI, MICHIGAN «0M 

TELEPHONE C313) 348-t477 


^1 


T3 




^ 


r;ii' 




:l';3 



else return(O); 
if(!== (headings- 1)) 

items = MAXLINES; 
for(j = 0;j<ftems; j++){ 

head->TopEdge = !TEM_HEIGHT * j; 

temp = head; 

head = head->Nex1ltem; 

if(head == NULL) 
retum{0); 

if(j== (items -1)) 
temp->Nexlltem = NULL; 



} 



} 



insert(p) 

struct X_Menullem *p; 

{ 
struct X^Menultem '11, •t2; 
struct IntuiText *s1, 's2; 

si = (struct IntuiText *) p->ltemFill; 
if(head){ 
t1 =head; 
t2 = NULL; 
while(t1){ 
s2 = (slfuct IntuiText ') t1 oltemFill; 
if((strcmp(s1 ->IText, s2->IText)) <= 0){ 
p->Nextltem = t1 ; 
if(t2 == NULL) 
head = p; 



else 

t2->Nextltem = p; 
return(O); 

} 

12=11; 

t1 =l1->Nextltem: 

) 

t2->Nextltem = p; 

} 

else 
head = p; 



PutStr(r, s) 

struct lOStdReq *r; 

char *s; 

{ 

r->io_Command = CMD_WRITE; 
r->io_Data = (APTR) s; 
r->io_Length = -1 ; 
DolO(r); 
return(O); 
} 

PutChar(r,c) 
struct lOStdReq *r; 
char c; 

( 
r->io_Command = CMD_WR!TE; 
r->io_Data ={APTR)&c; 
r->io_Length = 1; 
DoiO(r); 
return(O); 



myalloc(n) 
int n; 

( 
inti; 

i = maIloc(n); 
if(i == 0) 

abort("lnsufficient Memory" 
return(i); 



} 



■AC- 



every Amiga needs a good 
club 



Amiga Talk BBS/Club 



Founder of Arizona's 

FIRST Totaly Amiga Ofiented BBS 

24 hour 300/1200 Baud 

1-602- 935-6469 
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BECAUSE YOU'RE GOING TO BUY ONLY ONE 
DISK BACKUP UTILITY FOR YOUR 




MAKE IT 

jmmasi is everything you EXPECT 

Marauder works on oriy standard Amiga with 256K of memory and on© disk drive. 

Marauder backs up most copy-protected software titles. 

Marouder's user interface is clear-cut, easy to understand, and easy to use. 

tvlarouder's monuai is written in plain Englisti withiout confusing tectinical terms. 

Marauder insures that your valuable software investment will be protected 

ogainst theft, loss and accidental erasure. 

^nOS^DEl IS EVERYTHING YOU NEED 

Marauder lal<es advantage of Amiga's optionol external disk drive and extro RAfvl if you have them. 

MaurQuder, itselt. is not copy protected in any way. 

Marauder uses Amiga s advanced graphics and processing power to its fullest advantage. 

Morauder automatically formats your bocl<up disk while copying. 

Many complicated protection schemes ore easily handled by Marauder's 

parameter-entry mode — two numbers is all it takes. 

Current parameters for all titles will be available FREE to registered users at any time. 

BEST OF ALL 
>IIQ8SIDE<. is AVAILABLE NOW!!! 

You can get Ivlarauder at ttie 

SPECIAL INTRODUCTORY PRICE OF 

ONLY $39.95 m 

call now (215) 546-1533 

(i>eoier Inquiries Welcome) 

.'DISCOVERY 
^SOFTWARE 

262 South 15th Street .Suit© 300 • Philadelphia. PA 19102-3801 
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PRESENTS 

INFO BASE 

KowAVtiitbtt forttw Am^Q*I 

INFO BASE It a powertui, yiH Basy lo use Dala Bass program, dnlgnsd lor (he 
Amiga lo flora and reldeva iRlormalion in an organized manner. Each record can 
conlain up 19 ^00 HeKis of Inlormaiion . 

You crsalB, desijn. *^^ *^' custom prinl forms. Eacfi prin! form, you design, can 
crealo a dittereni 1JT» oi prinloul sucfi as mailing labels, mulli column repons. Inmicas. 
Gsts, etc.... In addition, text can b9 incorporalsd into 1Kb des'^n of print lorms, allowing 
bolli leit and field Inlormation to be printed on tha sama line. 

INFO BASE 

FEATUReS 
'DESIGN DATA BASES, ALLOWING UP TO 200 

FIELDS OF INFORMATION FOR EACH RECORD 
•SORT RECORDS BY ANY FIELD 

•SELECT STARTING AND ENDING SORT INFORMATION 
•PRINT OUTPUT TO PRINTER OR SCREEN 
•PRINT MULTIPLE COPIES 

■CREATE, DESIGN, AND EDIT CUSTOM PRINT FORMS 
•COMBINE TEXT INTO THE DESIGN OF PRINT FORMS 
■ADD RECORDS AND DELETE RECORDS 
■BROV/SE THROUGH RECORDS 
•SEARCH FOR SPECIFIC RECORDS 

INFO BASE is available NOWl M5.00 (USJ 

Enclose Chock, Mone/ Order, or Cashiers Chacli. 

Phone oiders win be sh'pped CO □. and must add S3. 00 S & H. 

Please altew 10-U dayi lor dolivsry. 

Box, 725 

Kenmore, NY 14217 

(716)877-3510 

Dealer Inquiries VVelcoTio 
INFO BASE rsquirei an Amiga with 512K RAM and alleasi one disk drive. 
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Eastern Telecom inc, 
9514 Brimton Drive 
Orlando, FL 32817 



It's Finally Here!! A Database 
Management System for the AMIGA 
with all the EXTRAS: 

• EXTRA — Easy to use. No new language to learn, just look at 

the pictures. 

• EXTRA — Flexibility, with pull down menus, automatic filing and 

field sizing. 

• EXTRA— On line help. Just press for command information. 

• EXTRA — LOW introductory price., .JUST $49.99 !!! 

We've got ALL the EXTRAS for you. 

Order NOW! (305) 657-4355 



"^ 



Ji 
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St>l>4'J$cM^ '' . Power 

r Play for '^the AMIGA. 




Pro 'MIDI Studio 






The most powerful 
performance and record- 
ing software on any 
computer. The recording 
studio-like environment provides com- 
plete facilities for routing, recording, 
editing, transposition and playback of 
any musical performance. As new 
modules are introduced, you can "install" 
them at any time. Music can be per- 
formed by the internal sampled sound 
synthesizer, or with any external MIDI 
equipment. Record from the QWERTY 
keyboard or any external MIDI source, 
including keyboards, guitar and pitch 
followers. Synchronize with, or provide 
MIDI clock information, including MIDI 
Song Pointers. The complete flexibility 
of the system makes your imagination 
the only limit to its power. 



• Number of notes and tracks deter- 
mined by available memory 

• MIDI patch panel links program 
modules 

• Install new modules at any time 

• Up to 16 internal instruments at one 
time 

• Complete sample system with editing, 
looping, ADSR envelopes, velocity 
sensitivity, and pitchbend. 



_ ."t A A A ^^-^ A .■, A r. 

wUmmmmmm 



up to 160 sampled sounds 
at one time 



• Save and load IFF note 
and sample files 

• Quantize to any multiple of MIDI clock 
beats 

• "Match" mode eases learning of a song 

• Complete MIDI sequence and song 
editing 

• Route, merge, split, or bounce any 
track to any other. 




MIDI Interface 




Necessary for any pro- 
gram which supports 
MIDI to communicate 
with MIDI equipment. 



• Completely compatible with the 
standard Amiga MIDI interface 

• MIDI In, Out, and Thru connectors 

• Plugs into the serial port 





Sound Digitizer 



With the SoundScape 
Sound Digitizer, any sound 
may be sampled and 
modified by the Amiga, 
including voice, IFF File compatibility 
enables these samples to be used as 
musical instruments, sound effects, 
or speech with any IFF compatible music 
or animation system. 



• High quality 

• Highest possible fidelity from the 
Amiga 

• Stereo or mono 

• Variable sample rates 

• Mike and line inputs 

• Digitally controlled volume on each 
channel 

• IFF Sample File compatible 

• Software included for sampling, 
editing, and MIDI performance 
functions 



Available From Your AMIGA Dealer. 




SoundScape Pro MIDI Studio 


$149.00 


AMIGA MIDI Interlace 


$ 49.00 



SoundScape Audio Digitizer 



$ 99.00 



midiciic 



.Amijjii 1% n Hide mark of Commodore Businesi Machine! 
Prices and availability subject to change without notice 



,J 'Ji^ JJ-' 
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...the professional software source!! 



P.O. Box 60238 Sta. A, Palo Alto, CA 94306 (408) 741-0117 




UNLEASH THE AWESOME POWER OF THE AMIGAi 

TliL- PAL h :i lurnkt-y i-xiuiiMim i.h;is-.iv ih.ii |iri>\nk-v the mihi ]iower1ul aikl com dTL-aivv hardware 
);r(}\Mii |i,ilh lor vour AMlCrA. 
f-'wiures: 
' Hij;li ipeL-d direc: .^miga DNU ciimri)lli.T antl iiarti disk 

• Fivf DMA L'xpansion sloLs 

• 1/2 Meg Itim with Cl(Kk'C;ileiid:ir 

• R(X>m fur multiple stiirai;e.r€lrieval devices 

• Fits comeniently uii top of your /\jnii;a 

• lOty'ii compatible with current and tlimre Aiiii>;;b 

• 1 til S megaliue ram card opiioiis 

• Optional pass through bus connector for further expansion 

• Optional proronping card 

• Fumre prcjduas currenth' under development 

r.yj. TODAY .\ND UNli«H THE RW OF VOIK .VMKi.V 



IINFOMINDER 



THE EiECTRONIC UBAARV AT VOUR RMGERTIPS 

INKOMlNDERLs an Intel lijjeni intbrntation resource that provides theuserwith instantaneous access lo 
relerence information stored within ihe Amiga personal cosuputer. 

• l-'ulh supixins multi-tasking 

• i-'asl accex^ liy menu or ciuiiine 

• Text capaliilities include: ji^tificatioii, Wortl Vira[). Multiple character f(inLVst\ies 

• Information content completely user dehnahle 

• Supfxirts comhinaiion i>f TEXT and 111- GK.M'illCS 

• i'rogrammaiic interface for context sensitive help 

• Narration and prititing of information 

• Expand and shrink topics 

INKOMINDER will revolutionize the way we access textual and graphical information. Stop searching 
and START using the information around you. Ciei INFOMINDER tixlay from BYTE by BYTE. 



WiJt&-H(ind. 



THE WORD PROCESSOR AND FORM LETTER GENERATOR 

WRITE HANI) is a general word prisessor and lorm letter generator that giviw you ihe mast features 
lor yi lur dolklr^- De\eli ijied ti i meet the s|H.'cial needs c >f Miiali business, Vi'TllTE IL-AND is e;Lsy to learn and 
easy to use. 

WRITE HAND challenges you to compare the following features dollar-for dollar, feature for-feature to 
those of other word processors on the market today, 

• E.xtensive on-line HEIJ' senice • Reviews and merges files while you edit 

• Form letter generator • Move^ bliKks of text and figures of any size 

• Powerlul editing capabilities • Provides v\ord wra|), Ixilding and underlining 

• Formats documents while you edit 

MakeViHITE RWD the t(H)l that Inovc^ your business into the produaive world of electronic word 
processing. 
Suggested Retail Price: fSO.OO 




THE TOTALLY INTEGRATED ACCOUMTING SYSTEM 

FiN.WCLU PLCS is the alTordable way in put \oLir liusiness at your fingertips, FSN.ANCl.Al. PUS is the 
complete accounting solution with five systems m one: 

• General Ledger • Payroll 

• Accounts Payable • VCord PriKessor 

• Accounts Receivable 

ITN.-VNCl.U PLl 'S is adaptable, Vou cusi I imize eaclui impany Liccordi ng 10 iLs size and !>! H ikkeeping needs, 

.\n easv-tij-read, eiisy to learn users guide pn ivides o miprehensive Inst ructions for setting up y( itir i iwn 
ba)b, Plain-English menus are the .system "roadniaps" for both the novice and for the more ex|X.'rienced, 

Because FIN.VsCLAL Pl.rS is a totally integrated accouiitaig system, no longer must you purchase individual 
packages, store entries on separate diskettes, or run confasing transfer programs to obtain complete 
integration. 

Suggested Retail Price. $29s.1K:i 
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